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Important Information 

Texas Instruments makes no warranty, either expressed or implied, including but not limited 
to any implied warranties of merchantability and fitness for a particular purpose, regarding 
any programs or book materials and makes such materials available solely on an "as-is" 
basis. 

In no event shall Texas Instruments be liable to anyone for special, collateral, incidental, or 
consequential damages in connection with or arising out of the purchase or use of these 
materials, and the sole and exclusive liability of Texas Instruments, regardless of the form of 
action, shall not exceed the purchase price of this product. Moreover, Texas Instruments 
shall not be liable for any claim of any kind whatsoever against the use of these materials by 
any other party. 
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Overview 



System 
Routines 



Entry point 
name: 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



The following is the format in which each of the entry points will appear. The 
entry points are listed alphabetically by category. 

Name used to identify the routine. 

Each entry point is identified by function into a category. 

Brief description of usage/purpose. How the routine works and additional 
information about the input. 

Setup values in processor registers. 

Setup values in processor flags (F register). 

OPX, stack or RAM locations initial conditions affecting results. 

Return information in processor registers. 
Return information in process flags. 
Return information in OPX, stack, or RAM. 

Processor registers whose initial values may be modified, so caller is 
responsible for preserving. 

RAM space needed, where applicable. 

Description of appropriate usage context, limitations, and any other useful 
information, side effects, assumptions, etc. 

An example of how to set up initial conditions and use the routine. 



NOTE () indicate indirection 
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1 



System Routines 
Display 



Bit_VertSplit |1-1 

CheckSplitFlag 

ClearRow 



1-2 



1-3 



ClrLCD 1-4 



ClrLCDFull 1-5 



ClrOP2S 1-6 



ClrScrn 1-7 



ClrScrnFull 1-8 



ClrTxtShd 1-9 



DispDone 1-10 



DispHL M-11 



Displaylmage |1-12| 



Displaylmage (continued) 1 1 - 1 3 

DispOPIA [TT4 

EraseEOL |1-15 

Form Base |1-16 

Form Base (continued) |1-17 

FormDCplx 

FormDCplx (continued) 



1-18 



1-19 



FormEReal 1-20 



Form Real 1-21 



Load Pattern 1-22 



Load SFont 1-23 



NewLine 1-24 



OutputExpr 1-25 



PutC 1-26 
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PutMap |1-27 

PutPS 1 1-28 

PutPS (continued) |1-29 

PutPSB |1 -30 

PutPSB (continued) |1-31 

PutS pT32 

PutS (continued) |1 -33 

PutTokString |1-34 

RestoreDisp |1-35 

RunlndicOff |1 -36 

RunlndicOn |1-37 

SaveDisp |1 -38 

SetNorm_Vals 1 1 -39 

SFont_Len 1 1 -40 

SStringLength |1-41 

VPutMap 1 1-42 

VPutS FT43 

VPutS (continued) 



1-44 



VPutSN 1-45 



VPutSN (continued) |1 -46 
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Bit_VertSplit 



Category: 

Description: 

Inputs: 

Registers: None 
Flags: None 
Others: None 

Outputs: 

Registers: None 



Display 

Tests if the TI-83 Plus is set to G-T (graph-table) display mode. 



Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



NZ = 1 if G-T mode is set 

None 

None 

Applications may want to reset the 83+ to full screen mode if graphing 
functionality is used. In G-T mode the screen is split vertically with 1/2 being 
the graph screen and the other the table display. 



B_CALL Bit_VertSplit 

JR NZ, Screen_is_Split 



test for G-T mode 
jump if G-T mode 
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CheckSplitFlag 



Category: Display 

Description: Checks if either horizontal or G-T split screen modes are active. 
Inputs: 

Registers: None 

Flags: grfSplitOverride, (IY + sGrFlags) = 1 to ignore split mode settings 

This flag is set to make system routines draw to the full screen even when in 
a split screen mode. 

Others: None 

Outputs: 

Registers: None 

Flags: Z = 1 if no split screen mode is active 
= 0 if a split screen mode is active 

Others: None 

Registers None 
destroyed: 

Remarks: 

Example: B_CALL CheckSplitFlag 
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ClearRow 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Display 

Clears eight consecutive LCD display drive rows. 

A = LCD display driver row coordinate (0x80 - OxBF) 

None 

None 

None 
None 

Eight pixel rows cleared 
Driver left in X increment mode 

A, B, DE 

This routine requires A to be in LCD display driver row (X) coordinates, 
which have a valid range between 0x80 - OxBF, with the top pixel row equal 
to 0x80 and the bottom pixel row equal to OxBF. Passing in a value for A 
outside this range will cause unpredictable results and probably a lockup. 
This routine erases eight consecutive rows, so if you pass in A = 0x88, the 
9th - 1 6th pixel rows from the top of the display are erased. If you pass in a 
value between 0xB9 - OxBF, the erased rows wrap back to the top of the 
display. In normal usage, if you are erasing a line of large text, the A value 
should be a multiple of 0x08. 



Example: 
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ClrLCD 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Display 

Clears the display. 
None 

G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. 
See ForceFullScreen. 

grfSplit, (IY + sGrFlags) = 1 if horizontal split mode set 
vertSplit, (IY + sGrFlags) = 1 if graph-table split mode set 
grfSplitOverride, (IY + sGrFlags) = 1 to ignore split modes 

None 

None 
None 
None 
All 

This routine only acts on the display, not the textShadow. 
Clear the display using the current split settings: 

B_CALL ClrLCD 
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ClrLCDFull 

Category: Display 

Description: Clears the display ignoring any split screen settings. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: Entire display is cleared. 

Registers All 
destroyed: 

Remarks: 

Example: b_call cirLCDFuii 
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ClrOP2S 

Category: Display 

Description: Sets the floating-point number in OP2 to be positive. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 
Registers 

destroyed: None 
Remarks: 

Example: b_call cirop2s 
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ClrScrn 



Category: 



Display 



Description: Clears the display. If textShadow is in use clears it also. 
Inputs: 

Registers: None 

Flags: appTextSave,(IY + appFlags) = 1 if the textShadow is to be cleared also 



G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this turn off the split screen modes. 
See ForceFullScreen. 

grfSplit, (IY + sGrFlags) = 1 if horizontal split mode set 
vertSplit, (IY + sGrFlags) = 1 if graph-table split mode set 
grfSplitOverride, (IY + sGrFlags) = 1 to ignore split modes 



Others: 



None 



Outputs: 

Registers: None 
Flags: None 



Others: 



Display and possibly textShadow cleared. 



Registers 
destroyed: 



All 



Remarks: 



Example: 



B_CALL 



ClrScrn 
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ClrScrnFull 

Category: Display 

Description: Clears the display entirely ignoring split screen settings. If textShadow is in 
use clears it also. 

Inputs: 

Registers: None 

Flags: appTextSave, (IY + appFlags) = 1 if the textShadow is to be cleared also 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: Display and possibly textShadow cleared. 

Registers All 
destroyed: 

Remarks: 

Example: b_call cirscmFuii 
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ClrTxtShd 



Category: Display 

Description: Clears the textShadow buffer. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: textShadow set to spaces. 



Flags: 

Others: 

Registers 
destroyed: 

Remarks: 
Example: 



None 
None 

BC, DE, HL 

ClrScrn falls into this routine which zeros out 128 bytes starting at 
textShadow (one byte for each 5x7 screen position (8 rows x1 6 columns)). 
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DispDone 



Category: Display 

Description: Displays Done on text screen. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers HL 
destroyed: 

Remarks: 

Example: B_CALL DispDone 
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DispHL 

Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 
Example: 



Display 

Converts the contents of HL to a decimal and writes it to the screen at 
current cursor position. The string displayed is always 5 characters and right 
justified. The large 5x7 font is used. 



HL = two-byte value to convert 

None 

None 



None 
None 

String displayed. (OP1) = start of five character decimal number string, right 
justified. 

AF, DE, HL 



If the string does not fit on the current display row then it is truncated at the 
screen's edge. 

Set HL = 357 and display it starting in row 0 column 0. 

LD HL, 0 

LD (curRow) , HL ; set cursor position 

r 

LD HL,357 

B_CALL DispHL 
RET 

what will be displayed is " 357", which has two leading spaces. 
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Displaylmage 



Category: 

Description: 

Inputs: 



Display 

Displays a bitmap image stored in RAM. 



Registers: HL = pointer to image structure 

Height of image in pixels — one-byte 
Width of image in pixels — one-byte 
Image data by rows 

The first byte contains the data for the first eight-pixels of the first row. Bit 7 
is the left-most pixel of the first row. 
Each new row starts on a byte boundary. 

There may be unused bits in the last byte of each row if the image is not a 
multiple of eight in width. 

DE = location on screen to place the upper left corner of the image, 
(row, column) 

(0,0) = upper left corner of the screen. 

The image can be oriented off of the screen: ffh = -1 . The only restriction is 
that the image cannot be entirely off screen. 



Flags: 



Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



plotLoc, (IY + plotFlags) 

bufferOnly, (IY + plotFlags) 
None 

None 
None 

Screen, graph buffer 
RAM locations @ ioPrompt 

All 



1 if image drawn to display only. 

0 if image drawn to display and graph buffer. 

1 if image drawn to graph buffer only. 
This flag overrides the plotLoc flag. 



ioPrompt + 7 



(continued) 
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Displaylmage (continued) 

Example: Display an image three-pixels high by 1 7 pixels wide at position (0,0) to the 
display only. 



LD 
LD 
LD 

LDIR 



HL, ImageData 
DE, OP1 
BC, 11 



; pointer to bitmap 



; copy image data to 
; RAM 



LD 
LD 



HL, OP1 
DE, 0 



; pointer to image 
; position of upper 
; left corner 



SET plotLoc, (IY+plotFlags) 

B_CALL Displaylmage 



ImageData : 



DB 
DB 



DB 
DB 



3, 17 

80h, 3eh, lOh 



llh, 35h, Oh 
Of fh, Olh, lOh 



; height, width 

row 1, only bit 7 
of the last byte 
is used 
row 2 
row 3 
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DispOPIA 



Category: 
Description: 

Inputs: 

Registers: 
Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Display 

Displays a floating-point number using either small variable width or large 
5x7 font. The value is rounded to the current "fix" setting (on the mode 
screen) before it is displayed. 



ACC = maximum number of digits to format for displaying 

textlnverse, (IY + textFlags) = 1 for reverse video 
textEraseBelow, (IY + textFlags) = 1 to erase line below character 
textWrite, (IY + sGrFlags) = 1 to write to graph buffer not display 
fracDrawLFont, (IY + fontFlags) = 1 to use large font, not small font 



(penCol) = pen column to display at 
(pen Row) = pen row to display at 



None 
None 
None 
All 

OP1, OP2, OP3, OP4 

Displaying stops if the right edge of the screen is reached. 
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EraseEOL 

Category: Display 

Description: Erases screen to end of line. 

Inputs: 

Registers: None 

Flags: None 

Others: curRow, curCol point to screen position. 

Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers None, saves registers beforehand, 
destroyed: 

Remarks: curRow, curCol are also saved and restored. 

If the sEditRunning, (IY + apiFlg3) flag is set (sfont running). 

Example: LD HL, 0801h ; curRow = 1, curCol = 8 

LD (curRow) , HL 

LD A, ' H ' 

B_CALL PutC 

LD A, ' I ' 

B_CALL PutC 

B_CALL EraseEOL ; clear to end of line 
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Form Base 



Category: 
Description: 



Inputs: 

Registers: 
Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Ram Used: 

Remarks: 



Display 

Converts a RealObj (single floating-point number) in OP1 into a displayable 
string. 

Use the current mode settings SCI, ENG, NORMAL and FIX setting to 
format the string. 

The output can also be formatted as a fraction or a Degrees, Minutes, 
Seconds (DMS) number. 



None 

To use the current format settings: 

(Flags + fmtFlags) copies to (Flags + fmtOverride) 

To override the current settings, modify the following flags: 

Resetting the next two flags sets NORMAL display mode. 
fmtExponent, (fmtOverride) = 1 for scientific display mode 
fmtEng, (fmtOverride) = 1 for engineering display mode 

Setting the next three flags will signify DMS formatting. 
fmtBin, (fmtOverride) 
fmtHex, (fmtOverride) 
fmtOct, (fmtOverride) 

Setting the next two flags will signify Fraction formatting. 
fmtHex, (fmtOverride) 
fmtOct, (fmtOverride) 

(fmtDigits) = OFFh for FLOAT, no fix setting 

= 0 - 9 if fix setting is specified 
OP1 = value to format. 



BC = length of string 
None 

String returned in RAM starting in OP3, and is 0 terminated 
All 

OP1 -OP6 

If the current display mode settings are SCI or ENG, the output string wil 
reflect the setting. The value is rounded based on the maximum width 
entered and the current fix setting. 

(continued) 
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Form Base (continued) 

Example: Generate a random number and display it at the current cursor position. Use 
all the current format settings except force SCI formatting. 



B_CALL 


Random 


; OP1 = random number 


LD 


A, (IY+fmtFlags) 


; get current format 






; settings 


RES 


fmtEng, A 




SET 


f mtExponent , A 


; override current and 






; set SCI formatting 


LD 


(IY+fmtOverride) ,A 


; set override flags 


B_CALL 


FormBase 


; generate the string 


LD 


HL, OP3 


; start of string 


B_CALL 


Puts 


; display string 
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FormDCplx 



Category: 
Description: 



Inputs: 

Registers: 
Flags: 



Others: 



Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 



Display 

Converts a CplxObj (pair of floating-point numbers) in OP1/OP2 into a 
displayable string. 

Use the current mode settings SCI, ENG, NORMAL, FIX setting, and 
complex number display format to format the string. 

The output can also be formatted as a fraction or a Degrees, Minutes, 
Seconds (DMS) number. 



None 

To use the current format settings: 

(Flags + fmtFlags) copies to (Flags + fmtOverride) 

To override the current settings, modify the following flags: 

Resetting the next two flags sets the NORMAL display mode. 
fmtExponent, (fmtOverride) = 1 for scientific display mode 
fmtEng, (fmtOverride) = 1 for engineering display mode 

These flags control the formatting of complex numbers. 
rectMode, (fmtOverride) = 1 for rectangular complex display 
fmtEng, (fmtOverride) = 1 for polar complex display 

Setting the next three flags will signify DMS formatting. 
fmtBin, (fmtOverride) 
fmtHex, (fmtOverride) 
fmtOct, (fmtOverride) 

Setting the next two flags will signify Fraction formatting. 
fmtHex, (fmtOverride) 
fmtOct, (fmtOverride) 

(fmtDigits) = OFFh for FLOAT, no fix setting 
= 0 - 9 if fix setting is specified 

OP1 = value to format 



BC = length of string 
None 

String returned in RAM starting in (fmtString), and is 0 terminated. 
All 

OP1 -OP6 



(continued) 
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FormDCplx (continued) 



Remarks: If the current display mode settings are SCI or ENG, the output string wil 
reflect the setting. The value is rounded based on the maximum width 
entered and the current fix setting. 

Example: Generate a random complex number and display it at the current cursor 
position. Use all the current format settings except force SCI formatting. 



B_CALL 
RST 



Random 
rPushRealOl 



; OP1 = random number 
; save 



B_CALL 
B_CALL 



Random 
PopReal02 



OP1 = random number 
OP2 = 2nd part of 
floating-point number 



LD A, (IY+fmtFlags) 

RES fmtEng,A 

SET FmtExponent, A 

LD ( IY+f mtOverride ) ,A 

B_CALL FormDCplx 



; get current format 

; settings 

; override current and 

; set SCI formatting 

; set override flags 

; generate the string 



LD 

B_CALL 



HL, fmtString 
PutS 



; start of string 
; display string 
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FormEReal 



Category: 
Description: 



Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Display 

Converts a RealObj (single floating-point number) in OP1 into a displayable 
string. 

This routine will ignore all format settings. 

Specify the maximum width allowed for the string generated. 

ACC = maximum width of output, minimum of six 
None 

OP1 = value to format 

BC = length of string 
None 

String returned in RAM starting in OP3, and is 0 terminated. 
All 

OP1 -OP6 

If the current display mode settings are SCI or ENG, the output string will 
reflect the setting. The value is rounded based on the maximum width 
entered and the current fix setting. 

Generate a random number and display it with a maximum of six characters 
at the current cursor position. Ignore all format settings when generating the 
string to display. 

B_CALL Random ; OP1 = random number 

LD A, 6 ; max width to format value with 

B_CALL FormEReal ; generate the string 

} 

LD HL,OP3 ; start of string 

B_CALL PutS ; display string 
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FormReal 



Category: 
Description: 

Inputs: 

Registers: 
Flags: 



Others: 



Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 



Example: 



Display 

Converts a RealObj (single floating-point number) in OP1 into a displayable 
string. 

Specify the maximum width allowed for the string generated. 

ACC = maximum width of output, minimum of six 

fmtExponent, (fmtFlags) = 1 for scientific display mode 
fmtEng, (fmtFlags) = 1 for engineering display mode 

If both of the above flags are reset, then NORMAL display mode. 

(fmtDigits) = OFFh for FLOAT, no fix setting 
= 0 - 9 if fix setting is specified 

OP1 = value to format 

BC = length of string 
None 

String returned in RAM starting in OP3, and is 0 terminated. 
All 

OP1 -OP6 

If the current display mode settings are SCI or ENG, the output string will 
reflect the setting. The value is rounded based on the maximum width 
entered and the current fix setting. 

Generate a random number and display it with a maximum of six characters 
at the current cursor position. 



B_CALL 
LD 

B_CALL 
LD 

B_CALL 



Random 
A, 6 

FormReal 

HL, OP3 
Puts 



OP1 = random number 

max width to format value with 

generate the string 

start of string 
display string 
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Load Pattern 



Category: Display 

Description: Loads the font pattern for a character to RAM. Also includes the characters 
width in pixels. This will work for both variable width and 5x7 fonts. 

Inputs: 

Registers: ACC = character equate 

Flags: fracDrawLFont, (IY + fontFlags) = 1 to use Large 5x7 font 

= 0 to use variable width font 

Others: None 
Outputs: 

Registers: None 
Flags: None 

Others: For large 5x7 font: RAM @ IFont_record = width of character, seven-byte 
font 

For variable width font: RAM @ sFont_record = width of character, seven- 
byte font 

The first byte of the font is the pixel mapping for the top row and each 
subsequent byte is the next row. 

The LSB of each byte represents the right most pixel of a row. 

Registers All 
destroyed: 

RAM used: 

Remarks: If fracDrawLFont is set, it must be reset. 
Example: 
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Load SFont 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Display 

Copies small font attributes to RAM for a particular display character. 

HL = offset into small font table 

None 

None 

HL = pointer to sFont_record RAM 
None 

sFont_record...sFont_record + 7 = font 
DE, HL 

This might be useful, if you wish to write your own LoadPattern or VPutMap 

routine for displaying small display characters. The system character fonts 
(large and small) use eight-bytes per character. 

To convert a character number to a table offset, multiply the number by 
eight. 

Find the width of the small display character f: 



LD 


A, ' F ' 




LD 


L, A 




LD 


H, 0 




ADD 


HL, HL 


* 2 turn character into an 
offset . 


ADD 


HL, HL 


* 4 


ADD 


HL, HL 


* 8 multiply by 8 to get 
table offset . 


B_CALL 


Load_SFont 


sFont_record = 

03, 00,02,04,06,04,04, 00 


LD 


A, (HL) 


1st byte is width 
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NewLine 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

Remarks: 



Display 

Move cursor to beginning of next line and scroll the display if necessary. 
None 

appAutoScroll, (lY+appFlags) = 1 to automatically scroll display 
None 

None 

textScrolled, (lY+textFlags) = 1 if display scrolled 
(curRow) is incremented if display does not scroll. 
(curCol) = 0. 
All 

Presumes that (winTop) has been previously initialized to the top of the 
window and (winBtm) has been initialized to the bottom of the window, (eg., 
usually winBtm = 8 and winTop = 0. In horizontal split screen, winTop = 4). 

Reset the appAutoScroll (lY+appFlags) flag to avoid scrolling the screen if 
on the bottom line. But if doing so, curRow may be incremented to an 
invalid state (eg, row 8 or above), so this condition needs to be checked and 
curRow re-initialized if you use this flag. 



Example: 
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OutputExpr 



Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 



Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

Remarks: 



Example: 



Display 

Converts a numeric value, string or equation, into a string and displays it 
using the large 5x7 font. This routine should be used with the split screen 
setting to set to FullScreen. 



H = column number to display at: e.g., 0...15 
L = row number to display at: e.g., 0...7 

textlnverse, (IY + textFlags) = 1 to display in reverse video 
appTextSave, (IY + appFlags) = 1 to write character to textShadow also 

OP1/OP2 = what to display: 

Floating-point number in OP1 
Complex number in OP1/OP2 

A variable name in OP1 of type: complex, list (real/complex), matrix, 
string, equation. 



None 
None 

System errors can be generated, See the Error Handlers section in Chapter 
2. 

String output to display. 
All 

Previous cursor setting is restored to curRow and curCol. Output will wrap to 
next line if complete string does not fit on a single line. Output will stop at 
bottom of screen. 

Output the contents of matrix variable [A] at cursor location row 2, column 3. 



Catch Error: 



LD 
RST 

AppOnErr 
LD 

B_CALL 
AppOf fErr 

RET 



HL, matAname 
rMov9ToOPl 

Catoh_Error 

HL, 3*256+2 
OutputExpr 



; OP1 = matrix [A] name 
; install error handler 
; row 2 column 3 
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PutC 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 
Example: 



Display 

Displays a character and advance cursor. 
A = character to display 

textlnverse, (lY+textFlags): 0 = normal character; 1 = invert character 
curRow, curCol = display row and column values 

None 
None 

curRow, curCol Updated 
None 

This routine calls PutMap to do the character display. 
This may cause a screen scroll if on the bottom line. 

; curRow = 1, curCol 



LD 
LD 
LD 

B_CALL 
LD 

B CALL 



HL, 0801h 
(curRow) , HL 
A, "H" 
PutC 
A, "I" 
PutC 



; (Puts might be more useful for multiple characters) 
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PutMap 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 
Example: 



Display 

Displays a character in the large font without affecting cursor position. 



ACC = character to display, see TI83plus.inc 

textlnverse, (IY + textFlags) = 1 to display in reverse video 
appTextSave, (IY + appFlags) = 1 to write char to textShadow also 
preClrForMode, (IY + newDispF) = 1 to preclear the character space before 

writing 

This is done when toggling between inverted and uninverted. 

(curRow) = home screen row to display in, 0-7 
(curCol) = home screen column to display in, 0-15 



None 
None 
None 
None 

See: PutC. 

Display char C in row 3 column 4: 



LD 
LD 



LD 

B CALL 



HL, 4*256+3 
( curRow) , HL 

A, ' C ' 

PutMap 



; set curRow & curCol 
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PutPS 



Category: 
Description: 

Inputs: 

Registers: 
Flags: 



Others: 

Outputs: 

Registers: 
Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Display 

Displays a string with a leading length byte residing in RAM, at the current 
cursor position, and stops at the bottom of the display. This routine uses the 
large 5x7 font. 



HL = pointer to length byte of string followed by the string 

textlnverse, (IY + textFlags) = 1 to display in reverse video 

appAutoScroll, (IY + appFlags) = 1 to scroll if need to display past the 

bottom of the display. 

appTextSave, (IY + appFlags) = 1 to write character to textShadow a\so. 

preClrForMode, (IY + newDispF) = 1 to preclear the character space before 

writing. This is done when toggling 
between inverted and noninverted. 

(curRow) = cursor row position, (0 - 7) 
(curCol) = cursor column position, (0-15) 



None 

Carry = 1 if entire string was displayed 
Carry = 0 if string did not fit in the display 

curRow and curCol are updated to the position after the last character 
displayed. 

All but DE 



It is recommended that this routine be placed in-line so that strings can be 
displayed from an application without copying them to RAM first. See the 
Display Routines section in Chapter 2 for further information. 

(continued) 
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PutPS (continued) 
Example: PutPS: 



PutPSlO : 

PutPS20 : 
PutPS30 : 



LD 
INC 
OR 
RET 

LD 
INC 



CALL 



LD 
LD 
LD 
CP 
RET 

DJNZ 
RET 



A, (HL) 
HL 

A 
Z 



; A = length of string 



; IF LENGTH IS 0 RET 



A, (HL) ; get a character of string name 

HL 



PutC 



; display one character of string 



A, (curRow) 
C, A 

A, (winBtm) 

C ; IS CURSOR OFF SCREEN ? 

Z ; RET IF YES 

PutPSlO ; display rest of string 
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PutPSB 



Category: 
Description: 

Inputs: 

Registers: 
Flags: 



Others: 

Outputs: 

Registers: 
Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Display 

Displays a string with a leading length byte residing in RAM, at the current 
cursor position, and stops at the right edge of the display. Ignores leading 
spaces. This routine uses the large 5x7 font. 



HL = pointer to length byte of string followed by the string 

textlnverse, (IY + textFlags) = 1 to display in reverse video 
appTextSave, (IY + appFlags) = 1 to write character to textShadow a\so. 



preClrForMode, (IY + newDispF) 



1 to preclear the character space before 
writing. This is done when toggling 
between inverted and noninverted. 



(curRow) = cursor row position, (0 - 7) 
(curCol) = cursor column position, (0-15) 



None 

Carry = 1 if entire string was displayed 
Carry = 0 if string did not fit in the display 

curRow and curCol are updated to the position after the last character 
displayed. 

All but DE 

It is recommended that this routine be placed in-line so that strings can be 
displayed from an application without copying them to RAM first. See the 
Display Routines section in Chapter 2 for further information. 

(continued) 
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PutPSB (continued) 

Example: PutPSB: 



PutPSBlO : 



PutPSB15 : 
PutPSB20 : 
PutPSB30 : 



LD 

LD 

INC 

OR 

RET 

LD 

CP 

JR 

JR 

LD 
CP 
JR 
LD 

B_CALL 
JR 

LD 

B_CALL 

INC 

DJNZ 

RET 



A, (HL) 

B, A 
HL 

A 
Z 

A, (HL) 

Z, PutPSB30 
PutPSB20 

A, (curCol) 
15 

C, PutPSB15 
A, (HL) 
PutMap 
PutPSB30 

A, (HL) 

PutC 

HL 

PutPSBlO 



; A = length of strinc 



; IF LENGTH IS 0 RET 



get column to print string 

last column? 

no, do regular PutC 

get a character of string name 

output character without newline 



; get a character of the string 
; display one character of string 

; display rest of string 
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PutS 



Category: 
Description: 

Inputs: 

Registers: 
Flags: 



Others: 

Outputs: 

Registers: 
Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Display 

Displays a zero (0) terminated string residing in RAM at the current cursor 
position. This routine uses the large 5x7 font. 



HL = pointer to start of string 

textlnverse, (IY + textFlags) = 1 to display in reverse video 

appAutoScroll, (IY + appFlags) = 1 to scroll if need to display past the 

bottom of the display. 

appTextSave, (IY + appFlags) = 1 to write character to textShadow a\so. 

preClrForMode, (IY + newDispF) = 1 to preclear the character space before 

writing. This is done when toggling 
between inverted and noninverted. 

(curRow) = cursor row position, (0 - 7) 
(curCol) = cursor column position, (0-15) 

None 

Carry = 1 if entire string was displayed 
Carry = 0 if string did not fit in the display 

curRow and curCol are updated to the position after the last character 
displayed. 

HL 

To avoid having to copy strings from an application to RAM before using this 
routine, it is much more efficient to place this routine inside of the 
application. By doing so, the application can display strings without first 
having to copy to RAM. 

(continued) 
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PutS (continued) 
Example: Puts: 



PutSlO : 



PutS20 : 



PUSH 
PUSH 
LD 
LD 

LD 
INC 
OR 
SCF 

JR 

B_CALL 

LD 
CP 
JR 

POP 
LD 
POP 
RET 



BC 
AF 

A, (winBtm) 

B, A 

A, (HL) 
HL 

A 



Z, PutS20 
PutC 

A, (ourRow) 
B 

C, PutSlO 

BC 
A, B 
BC 



; B = bottom line of window 

; get a character of string name 

end of string? 
indicate entire string was 
displayed 

yes > 

display one character of string 

; check cursor position 

; off end of window? 

; no, display rest of string 

; restore A (but not F) 

; restore BC 
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PutTokString 



Category: Display 

Description: Displays the string for a token at the current cursor location. 
Inputs: 

Registers: DE = token value. If a one-byte token then D = 0, E = token. 

Flags: None 

Others: (curRow) = home screen row to display in, 0 - 7 

(curCol) = home screen column to display in, 0 - 5 

Outputs: 

Registers: None 

Flags: None 

Others: String displayed with wrapping. 

Registers All 
destroyed: 

Remarks: 

Example: Display the string for the Sin( token at the current cursor location: 



LD 
LD 



D, 0 

E, tSin 



; DE = token 



B_CALL PutTokString ; get its string and display 

; it. 
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RestoreDisp 



Display 

Displays one to 64 rows of the display starting with the top row. 



Category: 
Description: 
Inputs: 

Registers: HL = pointer to ROM/RAM of the data for the first row to display, from left to 
right. This is followed by the remaining row's data. Each row is stored 
in 12-bytes, the first column is bit seven of the first byte for each row. 

B = number of pixel rows to be displayed 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: Data written to the display. 

Interrupts are disabled, turn them back on if needed. 
All 



Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



curXRow — 1 byte 



Copy the first 1 0 lines of the graph buffer to the display. 



LD 
LD 



B CALL 



HL,plotSSoreen 
B, 10 

RestoreDisp 



EI 



; start of buffer 
; 10 rows to display 



; re-enable interrupts 
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RunlndicOff 

Category: Display 

Description: Turns off run indicator. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: indicRun, (lY+indicFlags) = 0 

Others: None 

Registers Flag register 
destroyed: 



Remarks: 

Example: b_call Runindicoff 
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RunlndicOn 

Category: Display 

Description: Turns on run indicator. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: indicRun, (lY+indicFlags) = 1 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_CALL RunlndicOn 
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SaveDisp 



Category: Display 

Description: Copies a bit image of the current display to RAM. 
Inputs: 

Registers: HL = pointer to RAM location to save the image — the bit image of the 
display is 768 bytes in size. 

Flags: None 
Others: None 
Outputs: 

Registers: None 
Flags: None 

Others: Contents of display written to RAM. Interrupts are disabled. 
All 



Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



curXRow 

Split screen modes are ignored, the entire display is copied. 
Copy the current display to the graph backup buffer, plotSScreen. 



LD 

B_CALL 
RET 



HL, plotSScreen 
SaveDisp 
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SetNorm_Vals 

Category: Display 

Description: Sets display attributes to full screen mode. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: Display attributes set to full screen. Allows for full screen drawing and text 
displaying. 

Registers All 
destroyed: 

Remarks: This routine should only be used in combination with the setting of 

appropriate system flags that control the screen split settings. See the 
Display and Split Screen Modes sections in Chapter 2 for further 
information. 

Example: 
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SFont_Len 

Category: Display 

Description: Returns the width, in pixels, a character would use if displayed using the 
small variable width font. 

Inputs: 

Registers: HL = offset into the font look-up table. This is generated by multiplying the 
character equate of a character by eight. 

Flags: None 
Others: None 
Outputs: 

Registers: ACC = number of pixels needed to display the character using the small 
font. 

Flags: None 

Others: None 

Registers All B 
destroyed: 

Remarks: 

Example: Return the width in pixels of the small font character: 

LD HL, Scolon*8 ; compute offset 

B_CALL SFont_Len 
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SStringLength 

Category: Display 

Description: Returns the width in pixels a string would use if displayed using the small 
variable width font. 

Inputs: 

Registers: HL = pointer to the string, with the first byte being the number of characters 
in the string. The string must reside in RAM. 

Flags: None 
Others: None 
Outputs: 

Registers: ACC and B = number of pixels needed to display the string using the small 
font. 

Flags: None 

Others: None 

Registers All but HL 
destroyed: 

Remarks: 

Example: 
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VPutMap 

Category: 
Description: 



Inputs: 

Registers: 
Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Display 

Displays a character at the current pen location. Uses either the variable 
width font or the large 5x7 font. 

The advantage to displaying the large font with this routine instead of the 
PutC routine is the character can be placed at any location on the screen. 
With PutC routine, the characters can only be displayed in the 8 row by 16 
column grid specified by (curRow) and (curCol). 



ACC = character to display 

textlnverse, (IY + textFlags) = 1 for reverse video 

textEraseBelow, (IY + textFlags) = 1 to erase line below character applies to 

variable width font only 
textWrite, (IY + sGrFlags) = 1 to write to graph buffer instead of the display 
fracDrawLFont, (IY + fontFlags) = 1 to use large font, not small font 



(penCol) = pen column to display at 
(pen Row) = pen row to display at 



None 
None 

CA (carry) = 1 if could not fit in screen 
All but BC and HL 

Pen location (0,0) is the upper left corner of the display. 

The formatting flags are normally reset. An application should make sure 
that these flags are managed properly during execution and reset before 
returning to normal system operation. 

Draw the character C at pen location (0,0): 



LD 
LD 
LD 

B_CALL 



HL, 0 

(penCol) , HL 
A, ' C ' 

VPutMap 



set penRow and penCol 
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VPutS 



Category: 
Description: 



Inputs: 

Registers: 
Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Display 

Displays a zero (0) terminated string at the current pen location. Uses either 
the variable width font or the large 5x7 font. 

The advantage to displaying the large font with this routine instead of the 
PutS routine is the string can be placed at any location on the screen. With 
the PutS routine, the string can only be displayed in the 8 row by 16 column 
grid specified by (curRow) and (curCol). 



HL = pointer to 0 terminated string in RAM. 



textlnverse, (IY + textFlags) 
textEraseBelow, (IY + textFlags) 
textWrite, (IY + sGrFlags) 
fracDrawLFont, (IY + fontFlags) 

(penCol) = pen column to display at 
(pen Row) = pen row to display at 



1 for reverse video 

1 to erase line below character 

1 to write to graph buffer not display 

1 use 5x7 font 

0 use variable width font (default) 



None 
None 

CA = 1 if could not fit on the row of the screen entirely 
HL 

Pen location (0,0) is the upper left corner of the display. If fracDrawLFont is 
set, it must be reset. It is recommended that the following routine be placed 
in-line so that strings can be displayed from an application without copying 
them to RAM first. See the Display Routines section in Chapter 2 for further 
information. 



(continued) 
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VPutS (continued) 



Example: 



VPutS : 



VPutSlO : 



VputS20 : 



PUSH 
PUSH 
PUSH 

LD 
INC 
OR 
JR 

B_CALL 
JR 

POP 
POP 
POP 
RET 



AF 
DE 
IX 

A, (HL) 
HL 

A 

Z, VputS2 0 
VPutMap 
NC, VPutSlO 

IX 
DE 
AF 



get a character of string name 

end of string? 

yes > 

display one character of string 
display rest of string IF FITS 



Display Hello world in variable width font at the current pen location. 



LD 
LD 
LD 

LDIR 



HL, Hellostr 
DE, OP1 
BC, 14 



; copy string to RAM 



LD 

B CALL 



HL, OP1 

VPutS 



RET 



Hellostr : 



DE 



"Hello World", 0 
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VPutSN 

Category: 
Description: 



Inputs: 

Registers: 

Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Display 

Displays a string of known length at the current pen location. Uses either the 
variable width font or the large 5x7 font. 

The advantage to displaying the large font with this routine instead of the 
PutS routine, is the string can be placed at any location on the screen. With 
the PutS routine, the string can only be displayed in the 8 row by 16 column 
grid specified by (curRow) and (curCol). 



HL = pointer to first character of strii 
B = number of characters to display 

textlnverse, (IY + textFlags) 
textEraseBelow, (IY + textFlags) = 
textWrite, (IY + sGrFlags) 
fracDrawLFont, (IY + fontFlags) = 

(penCol) = pen column to display at 
(pen Row) = pen row to display at 



g in RAM 

1 for reverse video 

1 to erase line below character 

1 to write to graph buffer not display 

1 use 5x7 font 

0 use variable width font (default) 



None 
None 

CA = 1 if could not fit on the row of the screen entirely 
HL 



Pen location (0,0) is the upper left corner of the display. If fracDrawLFont is 
set, it must be reset. It is recommended that the following routine be placed 
in-line so that strings can be displayed from an application without copying 
them to RAM first. See the Display Routines section in Chapter 2 for further 
information. 

(continued) 
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VPutSN (continued) 



Example: 



VPutSN : 



PP10 : 



PP11 : 



PUSH 
PUSH 
PUSH 

LD 
INC 

B_CALL 
JR 

DJNZ 

POP 
POP 
POP 
RET 



AF 
DE 
IX 

A, (HL) 
HL 

VPutMap 
C, PP11 
PP10 

IX 
DE 
AF 



get a character of string name 

display one character of string 
JUMP IF NO ROOM ON LINE 
display rest of string 



Display Hello world in variable width font at the current pen location. 



LD 
LD 
LD 

LDIR 



HL, Hellostr 
DE, OP1 
BC, 14 



; copy string to RAM 



LD 
LD 

B CALL 



HL, OP1 
B, 11 

VPutSN 



; length of string 



RET 



Hellostr : 



DE 



"Hello World" 
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2 



System Routines 

Edit 



CloseEditBuf \2y\\ 

CloseEditBufNoR (2j2] 

CloseEditEqu 1^3 

CursorOff [2^4 

CursorOn [2^5 

DispEOL [2^6 

IsEditEmpty |F7 

KeyToString {2^8 

ReleaseBuffer J 2-9 
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CloseEditBuf 

Category: Edit 

Description: Close and deletes edit buffer without parsing. 
Inputs: 

Registers: None 

Flags: editOpen, (IY + editFlags) set if open 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: Adjusts free RAM pointers 

Registers All 
destroyed: 

Remarks: See CloseEditBufNoR for example. 
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CloseEditBufNoR 



Category: Edit 

Description: Closes edit buffer, but does not delete it. 
Inputs: 

Registers: None 

Flags: editOpen, (IY + editFlags) set if open 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: Adjusts free RAM pointers 

Registers All 
destroyed: 

Remarks: An edit session allocates all available RAM, but generally only a portion of that 
RAM is actually used. 

This routine is used to free up any extra RAM after an edit is finished and 
before the parser is invoked to evaluate the input. 

Same as: 



Example: 



B_CALL 
B_CALL 
RET 



_CALL 



NotEmpty : 



AtNarae : 



JR 

B_CALL 
RET 

B_CALL 

CALL 

B_CALL 

B_CALL 
RET 

LD 

LD 

LD 

LD 

XOR 

LD 

RET 



CanAlphlns 
CloseEditEqu 



IsEditEmpty 
NZ, NotEmpty 
CloseEditBuf 



CloseEditBufNoR 

AtName 

Parselnp 

ReleaseBuf f er 



HL, '@' 

A, EquObj 

(OP1), A 

(OP1+1), HL 
A 

(OP1+3), A 



cancel alpha and insert 
mode 

return edit buffer to 
user memory 



is edit buffer empty? 
no 

close & delete buffer 
without parsing 



close but do not delete 
Name of edit buffer 
parse, result -> OP1 
store result 
throw away edit buffer. 
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CloseEditEqu 



Category: Edit 

Description: Returns any unused portion of an edit buffer to memory. 
Inputs: 

Registers: None 

Flags: editOpen,(IY+editFlags) = 1 if edit buffer is open 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: Adjusts free RAM pointers. 



Registers All 
destroyed: 

Remarks: See also: CloseEditBufNoR 
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CursorOff 



Category: 

Description: 

Inputs: 



Turns off the cursor if it is turned on and disable blinking. 



Edit 



Registers: 
Flags: 



curOn, (IY + curFlags) = 1 if cursor is currently on. 



None 



appCurGraphic, (IY + appFlags) = 1 if the graphic cursor 
This mode should not be set by an application. 



appCurWord, (IY + appFlags) = 1 if a full word cursor 
This mode should not be set by an application. 



Others: 



If a normal edit cursor: 

(curRow), (curCol) = cursor location 

(curUnder) = character the cursor is covering 



If a graphic cursor: 

(curGX), (curGY) = center pixel location of cursor 
(curGStyle) = which graph cursor is active 

If a full word cursor: 

These are specific to the current context and entries are made in-line in the 
cursor blink routine. 



Outputs: 

Registers: None 

Flags: curOn, (IY + curFlags) = is reset 

curAble, (IY + curFlags) = is reset to disable future blinking 

Others: None 

Registers All 
destroyed: 

Remarks: 
Example: 
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CursorOn 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 



Others: 



Outputs: 

Registers: 
Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Edit 

Enables cursor blinking and show the cursor. 



None 

curLock, (IY + curFlags) = 1 if cursor is locked disabled, the cursor 
cannot be turned on to blink. 

appCurGraphic, (IY + appFlags) = 1 if the graphic cursor 
This mode should not be set by an application. 

appCurWord, (IY + appFlags) = 1 if a full word cursor 
This mode should not be set by an application. 

If a normal edit cursor: 

(curRow), (curCol) = cursor location 

If a graphic cursor: 

(curGX), (curGY) = center pixel location of cursor 
(curGStyle) = which graph cursor is active 

If a full word cursor: 

These are specific to the current context and entries are made in-line in the 
cursor blink routine. 



None 

curOn, (IY + curFlags) = is set 

curAble, (IY + curFlags) = is set to enable future blinking 

(curUnder) = character the cursor is covering 

All 
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DispEOL 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Edit 

Displays edit buffer to End of Line. 

None 
None 

editBuffer pointers 



Display modified 

None 

None 

AF, BC, DE, HL 

Displays buffer from editTail to editBtm or until the end of the line is reached. If 
the buffer is finished before reaching the end of line, then EraseEOL is called 
to erase to the end of the line. Current curCol value is saved and restored by 
this routine; it is not modified. Since this routine only displays to the end of the 
current line, curRow is not modified. 



Example: 
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IsEditEmpty 



Category: Edit 

Description: Tests if the Edit Buffer is empty. This is accomplished by confirming (editTail) 
equals (editBtm) AND (editCursor) equals (editTop). 

Inputs: 

Registers: None 
Flags: None 

Others: editTop, editCursor, editTail and editBtm pointer values must be valid - the edit 
session must be active. 

Outputs: 

Registers: None 

Flags: Z = 1 (edit buffer is empty) 

= 0 (edit buffer is not empty) 

Others: None 

Registers A, DE, HL 
destroyed: 

Remarks: This module is essentially a BCall to isAtBtm followed by a BCall to 
isAtTop. 

Refer to isAtTop, isAtBtm modules for additional operational details. 

Example: 
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KeyToString 



Converts key to a string value. 



Category: Edit 
Description: 
Inputs: 

Registers: DE = key 

D = 0 if a one-byte key 

Flags: None 

Others: None 
Outputs: 

Registers: HL = keyToStrRam (keyForStr + 1 ) 

Flags: None 

Others: keyForStr initialized to string 
AF, BC, DE, HL 



Registers 
destroyed: 

Remarks: 



Example: 



Keys are converted to tokens (if possible) and the token string copied to the 
keyForStr RAM area (18 bytes). 

HL points to the length byte of the string (in keyToStrRam). 
See TI83plus.inc for key and token values. 

To display the string for the Continue key: 



LD 


D, 0 


"Continue" is a one byte key, 
so set to 0 . 


LD 


E, kCont 


"Continue" 


B_CALL 


KeyToString 


convert to string: HL points 
to keyToStrRam. 


B_CALL 


PutPSB 


display string preceded by a 
length byte . . . 


B_CALL 


EraseEOL 


erase the rest of the line if 
need be . 



keyToStrRam would appear as follows: 
08h, 43h, 6Fh, 6Eh, 74h, 69h, 6Eh, 75h, 65h 

(Length of string is eight bytes, followed by the ASCII characters Continue.) 
See TI83plus.inc or Appendix B for the TI-83 Plus character set values. 
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ReleaseBuffer 

Category: Edit 

Description: Deletes numeric edit buffer. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 



Registers All 
destroyed: 

Remarks: After evaluation and an edit buffer is no longer needed, it is important to delete 
that buffer so that it doesn't take up unnecessary RAM. 

This routine can be included as part of an evaluation routine (if the buffer does 
not need to be redisplayed or edited), or as part of a putaway routine as you 
are leaving a context and returning back to the system. 

See CloseEditBufNoR for example. 

Example: 
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3 



System Routines 
Error 



ErrArgument 1 3-1 

ErrBadGuess [3^2 

ErrBreak [3^3 

ErrD_OP1_0 [3^4 

ErrD_OP1_LE_0 [3^5 

ErrDOPI Not_R [3^6 

ErrD_OP1NotPos [3^7 

ErrD_OP1 NotPosInt [3^8 

ErrDataType [3^9 

ErrDimension |3-10 

ErrDimMismatch 1 3- 1 1 

ErrDivByO |3-12 

ErrDomain |3-13 

Errlncrement 3-14 

Errlnvalid |3-15 

Errlterations |3-16 

ErrLinkXmit |3-17 

ErrMemory |3-18 

ErrNon_Real |3-19 

ErrNonReal |3-20 

ErrNotEnoughMem |3-21 

ErrOverflow |3-22 

ErrSignChange |3-23 

ErrSingularMat |3-24 

ErrStat |3-25 

ErrStatPlot |3-26 

ErrSyntax |3-27 

ErrTolTooSmall |3-28 

ErrUndefined |3-29 

JError |3-30 

JErrorNo 13-31 
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ErrArgument 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: ARGUMENT. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrArgument 
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ErrBadGuess 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: BAD GUESS. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrBadGuess 
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ErrBreak 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: BREAK. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrBreak 
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ErrD_OP1_0 

Category: Error 

Description: If OP1 = 0.0, domain error system will take over with message ERR: DOMAIN. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers A 
destroyed: 

Remarks: 

Example: b_jump ErrD_opi_o 
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ErrD_OP1_LE_0 

Category: Error 

Description: If OP1 0 (not positive), domain error system will take over with message 
ERR: DOMAIN. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers A 
destroyed: 

Remarks: 

Example: B_JUMP ErrD_OPl_LE_0 
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ErrD_OP1Not_R 

Category: Error 

Description: If OP1 is not real, domain error system will take over with message 
ERR: DOMAIN. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers A 
destroyed: 

Remarks: 

Example: B_JUMP Er rD_OP lNot_R 
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ErrD_OP1 NotPos 

Category: Error 

Description: If OP1 is not positive, domain error system will take over with message 
ERR: DOMAIN. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers A 
destroyed: 

Remarks: 

Example: B_JUMP ErrD_OPlNotPos 
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ErrD_OP1NotPoslnt 

Category: Error 

Description: If OP1 is not positive integer, domain error system will take over with message 
ERR: DOMAIN. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers A 
destroyed: 

Remarks: 

Example: B_JUMP ErrD_OPlNotPosInt 
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ErrDataType 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: DATA TYPE. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrDataType 
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ErrDimension 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: INVALID DIM. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrDimension 
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ErrDimMismatch 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: DIM 
MISMATCH. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrDimMismatch 
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ErrDivByO 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: DIVIDE BY 0. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrDivByO 
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ErrDomain 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: DOMAIN. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrDomain 
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Errlncrement 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: INCREMENT. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP Errlncrement 



TI-83 Plus Developer Guide 



3-14 



Third Release January 25, 2002 



System Routines — Error 



Errlnvalid 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: INVALID. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP Errlnvalid 
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Errlterations 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: ITERATIONS. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP Errlterations 
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ErrLinkXmit 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: IN XMIT. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrLinkXmit 



TI-83 Plus Developer Guide 



3-17 



Third Release January 25, 2002 



System Routines — Error 



ErrMemory 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: MEMORY. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrMemory 
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ErrNon_Real 

Category: Error 

Description: In Real mode, the result of a calculation yielded a complex result. This error is 
not returned during graphing. The TI-83 Plus allows for undefined values on a 
graph. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: The error system will take over and report the error to the screen. Any 
application that was executing at that time will be aborted. 

Example: B_JUMP ErrNon_Real 
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ErrNonReal 

Category: Error 

Description: Errors if nonreal input to command error. System will take over with message 
ERR: DATA TYPE. 

Inputs: 

Registers: B = number of arguments to check. 
Flags: None 

Others: Arguments on Floating Point Stack. 
Outputs: 

Registers: None 
Flags: None 

Others: Error if nonreal input to command. 

Screen will have data type error menu. 

Registers A, B 
destroyed: 

Remarks: 

Example: B_JUMP ErrNonReal 
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ErrNotEnoughMem 

Category: Error 

Description: If not enough memory, memory error system will take over with message 
ERR: MEMORY. 

Inputs: 

Registers: HL = number of bytes needed. 

Flags: None 

Others: None 
Outputs: 

Registers: DE = Amount of memory requested. 

Flags: CA = 1 if not enough room. 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrNotEnoughMem 
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ErrOverflow 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: OVERFLOW. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrOverflow 
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ErrSignChange 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: NO SIGN 
CHANGE. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrSignChange 
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ErrSingularMat 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: SINGULARITY. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrSingularMat 
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ErrStat 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: STAT. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: b_jump Errstat 
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ErrStatPlot 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: STATPLOT. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: b_jump Errstatpiot 
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ErrSyntax 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: SYNTAX. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrSyntax 
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ErrTolTooSmall 

Category: Error 

Description: Jumps to system error handler routine with message ERR: TOL NOT MET. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrTolTooSmall 
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ErrUndefined 

Category: Error 

Description: Jumps to system error handler routine with the message ERR: UNDEFINED. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: B_JUMP ErrUndefined 
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JError 



Category: 
Description: 



Inputs: 

Registers: 

Flags: 
Others: 
Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

Remarks: 

Example: 



Error 

Entry point into system error routine. This entry is almost always used in 
conjunction with an error exception handler. 

After an error exception handler is tripped and control is returned to an 
application, the application may choose to modify the error by changing the 
error to another or most likely removing the GoTo option. This entry point is 
where the application would B JUMP to continue on with the error after 
modifying it. 

See the Error Handers section in Chapter 2. 



ACC bits (0 - 6) = error code 

ACC bit (7) = 0 for no GoTo option 

ACC bit (7) = 1 for allowing a GoTo option 

None 

None 



None 
None 

(errNo) = error code (one-byte) 

System error is displayed or another error. 

Exception handler is tripped and the error is suppressed. 

All 



TI-83 Plus Developer Guide 



3-30 



Third Release January 25, 2002 



System Routines — Error 

JErrorNo 

Category: Error 

Description: Same as JError except the error code is stored in the byte (errNo). 
Remarks: See JError. 
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4 



System Routines — 
Floating Point Stack 



AllocFPS 4-1 



AllocFPSI 4-2 



CpyStack |4-3 

CpyOUoFPST, Cpy01ToFPS1 , Cpy01ToFPS2, Cpy01ToFPS3, 
Cpy01ToFPS4, Cpy01ToFPS5, Cpy01ToFPS6, Cpy01ToFPS7, 
Cpy02ToFPST, Cpy02ToFPS1 , Cpy02ToFPS2, Cpy02ToFPS3, 
Cpy02ToFPS4, Cpy03ToFPST, Cpy03ToFPS1 , Cpy03ToFPS2, 



Cpy05ToFPS1 , Cpy05ToFPS3, Cpy06ToFPST, Cpy06ToFPS2 \±4 



CpyTol FPST, CpyTol FPS1 , CpyTol FPS2, CpyTol FPS3, CpyTol FPS4, 
CpyTo1FPS5, CpyTol FPS6, CpyTol FPS7, CpyTol FPS8, CpyTol FPS9, 
CpyTol FPS1 0, CpyTol FPS1 1 , CpyTo2FPST, CpyTo2FPS1 , CpyTo2FPS2, 
CpyTo2FPS3, CpyTo2FPS4, CpyTo2FPS5, CpyTo2FPS6, CpyTo2FPS7, 
CpyTo2FPS8, CpyTo3FPST, CpyTo3FPS1 , CpyTo3FPS2, CpyTo4FPST, 
CpyTo5FPST, CpyTo6FPST, CpyTo6FPS2, CpyTo6FPS3 gjj 



CpyToFPST |4-6 



CpyToFPSI |4-7 



CpyToFPS2 4-8 



CpyToFPS3 4-9 



CpyToStack |4-10 



PopMCplxOI |4-11 



PopOPI, PopOP3, PopOP5 4-12 



PopReal 14-13 



PopRealOl, PopReal02, PopReal03, PopReal04, PopReal05, PopReal06 4-14 



PushMCplxOI, PushMCplx03 4-15 



PushOPI, PushOP3, PushOP5 4-16 



PushReal 4-17 



PushRealOl, PushReal02, PushReal03, PushReal04, PushReal05, 

PushReal06 14-18 
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AllocFPS 

Category: Floating Point Stack 

Description: Allocates space on the Floating Point Stack by specifying a number of 
nine-byte entries. 

Inputs: 

Registers: HL = number of entries to allocate 
Flags: None 
Others: None 
Outputs: 

Registers: None 
Flags: None 

Others: If no memory error, the new entries are allocated on the end of the FPS. 
FPST = last new entry allocated. 

Registers All 
destroyed: 

Remarks: No initialization of the allocated entries is done. See section on Floating Point 
Stack. 

Example: 
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Floating Point Stack 



AllocFPSI 

Category: Floating Point Stack 

Description: Allocates space on the Floating Point Stack by specifying a number of bytes, 
THIS MUST BE A MULTIPLE OF NINE. 

Inputs: 

Registers: HL = number of bytes to allocate — a multiple of nine. 
Flags: None 
Others: None 
Outputs: 

Registers: None 
Flags: None 

Others: If no memory error, the new entries are allocated on the end of the FPS. 
FPST = last new entry allocated. 

Registers All 
destroyed: 

Remarks: No check is made for the number of bytes being a multiple of nine. No 

initialization of the allocated entries is done. See section on Floating Point 
Stack. 

Example: 
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CpyStack 

Category: 
Description: 



Input: 

Registers: 



Flags: 
Others: 
Output: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Floating Point Stack 

Copies nine-bytes from one of the systems nine-byte stacks, FPS and ES. 
Only the FPS (Floating Point Stack) is documented for application use. This 
routine should be used in the manner described in the example. 



C = number of bytes from the next free byte in the stack back to the entry 
copying from. This will always be a multiple of nine. 

HL = address of next free byte for the stack, for the FPS the address is stored 
in the bytes (FPS). 

DE = pointer to the nine-bytes of RAM to copy the entry to. 

None 

None 

HL = pointer to byte after the entry just copied from. 
DE = DE + 9 

None 

Nine bytes copied to the RAM from the stack entry. 
All 

See Floating Point Stack documentation. 
Copy from FPSIOto OP2. 



LD 
LD 



HL, (FPS) ; copy to FPS 

DE, (OP2) ; start of 9 bytes to copy to 
; FPS10 



LD 



C, (10+1) *9 ; C = offset back to FPS10, 
; 11*9 bytes 



_CALL 



CpyStack ; copy to OP2 from FPS10 
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CpyOIToFPST, Cpy01ToFPS1, Cpy01ToFPS2, 
Cpy01ToFPS3, Cpy01ToFPS4, Cpy01ToFPS5, 
Cpy01ToFPS6, Cpy01ToFPS7, Cpy02ToFPST 5 
Cpy02ToFPS1 , Cpy02ToFPS2, Cpy02ToFPS3 5 
Cpy02ToFPS4 5 Cpy03ToFPST, Cpy03ToFPS1 , 
Cpy03ToFPS2, Cpy05ToFPS1 , Cpy05ToFPS3, 
Cpy06ToFPST, Cpy06ToFPS2 

Category: Floating Point Stack 

Description: This description covers a group of routines that copies a single nine-byte OP 
register (OP1 - OP6), to an entry on the Floating Point Stack (FPS). 
For example, Cpy01ToFPS2: OP1 is copied to (FPS2). 

Inputs: 

Registers: None 
Flags: None 

Others: OP register = 9 bytes to copy to FPS entry 

For example, Cpy01ToFPS2: OP1 = nine-bytes to copy 

Outputs: 

Registers: DE = FPS entry following the one copied to 

For example, Cpy01ToFPS2: DE = address of FPS1 

HL = OP register + 9 

For example, Cpy01ToFPS2: HL = OP1 + 9 
Flags: None 

Others: OP register = copy of the nine-byte FPS entry 
For example, CpyTo1FPS2: OP1 = FPS2 entry 

Registers All 

destroyed: The 0p register js written t0 

Remarks: These routines do not allocate or deallocate entries. See entry point 

CpyToStack. See entry point CpyTolFPST. See Floating Point Stack section 
of Chapter 2. 

Example: 
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CpyTol FPST, CpyTo1FPS1 5 CpyTol FPS2, 
CpyTol FPS3, CpyTol FPS4, CpyTol FPS5, 
CpyTol FPS6, CpyTol FPS7, CpyTol FPS8, 
CpyTol FPS9, CpyTol FPS1 0, CpyTol FPS1 1 , 
CpyTo2FPST 5 CpyTo2FPS1 5 CpyTo2FPS2, 
CpyTo2FPS3, CpyTo2FPS4, CpyTo2FPS5 5 
CpyTo2FPS6, CpyTo2FPS7, CpyTo2FPS8 5 
CpyTo3FPST 5 CpyTo3FPS1 5 CpyTo3FPS2, 
CpyTo4FPST 5 CpyTo5FPST, CpyTo6FPST, 
CpyTo6FPS2, CpyTo6FPS3 

Category: Floating Point Stack 

Description: This description covers a group of routines that copies a single nine-byte entry 
from the Floating Point Stack (FPS), to one of the OP registers (OP1 - OP6). 
For example, CpyTol FPS2: (FPS2) is copied to OP1 . 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: HL = FPS entry following one copied 

For example, CpyTol FPS2: HL = address of FPS1 

DE = OP register + 9 

For example, CpyTol FPS2: DE = OP1 + 9 
Flags: None 

Others: OP register = copy of the nine-byte FPS entry 
For example, CpyTol FPS2: OP1 = FPS2 entry 

Registers All 

destroyed: The OP register is written to. 

Remarks: These routines do not allocate or deallocate entries. See entry point 

CpyStack. See entry point CpyOIToFPST. See Floating Point Stack section 
of Chapter 2. 

Example: 
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CpyToFPST 



Category: Floating Point Stack 

Description: Copies nine-bytes from RAM/ROM to FPST, Floating Point Stack top entry. 
Input: 

Registers: DE = address of nine-bytes to copy to FPST 

Flags: None 

Others: None 

Output: 

Registers: HL = input DE + 9 

DE = (FPS), next free byte on the stack 

Flags: None 

Others: None 

Registers All 
destroyed: 

Remarks: See Floating Point Stack documentation. 
Example: 
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CpyToFPSI 



Category: Floating Point Stack 

Description: Copies nine-bytes from RAM/ROM to FPS1 , Floating Point Stack top entry -1 . 
Input: 

Registers: DE = address of nine-bytes to copy to FPS1 

Flags: None 

Others: None 

Output: 

Registers: HL = input DE + 9 

DE = pointer to FPST entry 

Flags: None 

Others: None 

Registers All 
destroyed: 

Remarks: See Floating Point Stack documentation. 
Example: 
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CpyToFPS2 



Category: Floating Point Stack 

Description: Copies nine-bytes from RAM/ROM to FPS2, Floating Point Stack top entry -2. 
Input: 

Registers: DE = address of nine-bytes to copy to FPS2 

Flags: None 

Others: None 

Output: 

Registers: HL = input DE + 9 

DE = pointer to FPS1 entry 

Flags: None 

Others: None 

Registers All 
destroyed: 

Remarks: See Floating Point Stack documentation. 
Example: 
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CpyToFPS3 



Category: Floating Point Stack 

Description: Copies nine-bytes from RAM/ROM to FPS3, Floating Point Stack top entry -3. 
Input: 

Registers: DE = address of nine-bytes to copy to FPS3 

Flags: None 

Others: None 

Output: 

Registers: HL = input DE + 9 

DE = pointer to FPS2 entry 

Flags: None 

Others: None 

Registers All 
destroyed: 

Remarks: See Floating Point Stack documentation. 
Example: 
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CpyToStack 



Category: Floating Point Stack 

Description: Copies nine-bytes to one of the systems nine-byte stacks, FPS and ES. Only 
the FPS (Floating Point Stack) is documented for application use. This routine 
should be used in the manner described in the example. 

Input: 

Registers: C = number of bytes from the next free byte in the stack back to the entry 
copying to. This will always be a multiple of nine. 

HL = address of next free byte for the stack, for the FPS the address is stored 
in the bytes (FPS). 

DE = pointer to the nine-bytes to copy to the stack. 

Flags: None 

Others: None 

Output: 

Registers: HL = pointer to byte after the entry just copied to. 
DE = DE + 9 

Flags: None 

Others: Nine-bytes copied to the stack entry. 

Registers All 
destroyed: 

Remarks: See Floating Point Stack documentation. 

Example: Copy from OP2 to FPS1 0. 

LD HL, (FPS) ; copy to FPS 

LD DE, (OP2) ; start of 9 bytes to copy to 

; FPS10 

LD C, (10 + 1) *9 ; C = offset back to FPS10, 

; 11*9 bytes 

B_CALL CpyToStack ; copy to FPS10 
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PopMCplxOI 



Category: Floating Point Stack 

Description: Pops a complex value from the FPS (FPS1 = real part; FPST = imaginary 
part). No checks are made on the data that is popped from the stack. 

Inputs: 

Registers: None 
Flags: None 

Others: FPS1 = real part of complex number 

FPST = imaginary part of complex number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 contains 9 bytes of data from FPS1 

OP2 contains 9 bytes of data from FPST 

Registers All 
destroyed: 

Remarks: This routine will remove 18 bytes of data from the FPS regardless of the data 
type. 

See PopRealOl, PopOPL See the Floating Point Stack section. 

Example: 
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PopOPI, PopOP3, PopOP5 



Category: 
Description: 



Input: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

RAM used: 
Remarks: 

Example: 



Floating Point Stack 

This description covers three entry points that are similar. The description is 
given for PopOPI . The inputs/outputs are the same for the other two routines 
replacing OP1/OP2 with either OP3/OP4 or OP5/OP6. 

These routines will pop either one or two floating-point numbers off of the top 
of the FPS. They are used to either pop a real or a complex value off of the top 
of the FPS without knowing in advance whether a real or a complex value is 
on the top of the stack. 

The top entry (FPST) is popped into OP1 . The sign byte of the popped value in 
OP1 is checked for CplxObj. If it is complex, OP1 is moved to OP2 and the 
new FPST is popped into OP1 . If it is not complex, the floating-point number 
popped into OP1 is left there. 



None 
None 
None 

None 
None 

If the data type of FPST = RealObj then OP1 = FPST 
If the data type of FPST = CplxObj then OP1 = FPS1 , 
the real part of the complex value 
OP2 = FPST, the imaginary part of the complex value. 

All 

OP1/OP2 or OP3/OP4 or OP5/OP6 depending on which of the routines is 
used. 

When using this routine make sure that the FPST entry is not a complex 
variable name. If it is, it will be interpreted as a complex value causing two 
floating-point numbers to be popped from the FPS. See PopRealOl and 
PopMcplxOL See Floating Point Stack section. 
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PopReal 

Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 
Example: 



Floating Point Stack 

Pops the last entry FPST, off of the FPS to an input RAM location. No matter 
what the data in FPST is only nine (9) bytes are popped off of the stack. 



DE = pointer to RAM location to pop FPST into 

None 

None 



DE = DE + 9 
None 

The nine-byte entry FPST is removed from the FPS and copied to the 
nine-bytes starting at address DE. 

All but the ACC 



The entry is removed from the FPS shrinking the size of the FPS by 
nine-bytes. See the Floating Point Stack section. 
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PopRealOl, PopReal02, PopReal03, PopReal04, 
PopReal05, PopReal06 

Category: Floating Point Stack 

Description: This description covers six entry points that are similar. The description is 
given for PopRealOl. The inputs/outputs are the same for the other five 
routines replacing OP1 with either OP2, OP3, OP4, OP5 or OP6. 

Pops the last entry FPST, off of the FPS to OP1 . No matter what the data in 
FPST is, only nine (9) bytes are popped off of the stack. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: The nine-byte entry FPST is removed from the FPS and copied to the 
nine-bytes starting at address OP1 . 

Registers 
destroyed: 

Remarks: The entry is removed from the FPS shrinking the size of the FPS by 
nine-bytes. See PopOPI . See the Floating Point Stack section. 

Example: 
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PushMCplxOI, PushMCplx03 



Category: Floating Point Stack 

Description: PushMCplxOI pushes a complex value onto the FPS (OP1 = real part; OP2 = 
imaginary part). No checks are made on the data that is put onto the stack. 
PushMCplx03 accomplishes the same task, except inputs are OP3 and OP4. 

Inputs: 

Registers: 
Flags: None 
Others: None 

Outputs: (OP1)...(OP1+8) and (OP2)...(OP2+8) contain 18 bytes of data to be pushed. 

Registers: None 
Flags: None 

Others: FPS1 = 9 bytes from OP1 

FPST = 9 bytes from OP2 

Registers All 
destroyed: 

Remarks: Memory error if not enough free RAM. 

See PushRealOl , PushOPI . See the Floating Point Stack section. 

Example: 
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PushOPI, PushOP3, PushOP5 



Category: 
Description: 



Input: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

RAM used: 

Remarks: 



Example: 



Floating Point Stack 

This description covers three entry points that are similar. The description is 
given for PushOPI . The inputs/outputs are the same for the other two routines 
replacing OP1/OP2 with either OP3/OP4 or OP5/OP6. 

These routines will push either one or two floating-point numbers onto the 
FPS. It is used to either push a real or a complex value onto the FPS without 
knowing in advance whether a real or a complex value is being pushed onto 
the stack. 

The sign byte of OP1 is checked for CplxObj. If it is Complex, OP1 is pushed 
on to the stack and the OP2 is pushed onto the stack. If it is not complex, the 
floating-point number in OP1 is only pushed onto the stack. 



None 
None 
None 

None 
None 

If the data type of OP1 = RealObj then FPST = OP1 
If the data type of OP1 = CplxObj then FPS1 = OP1 , 
the real part of the complex value 
FPST = OP2, the imaginary part of the complex value. 

All 

None 

When using this routine make sure that the OP1 is not a complex variable 
name. If it is it will be interpreted as a complex value causing two floating-point 
numbers to be pushed onto the FPS. See PushRealOl, PushMcplxOL See 
the Floating Point Stack section. 
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PushReal 

Category: Floating Point Stack 

Description: Pushes a new entry onto the FPS and copy the nine-bytes at address HL into 
the new entry. No checks are made on the data that is put onto the stack. 

Inputs: 

Registers: HL = pointer to nine-bytes to push onto the FPS 
Flags: None 
Others: None 
Outputs: 

Registers: HL = HL + 9 
Flags: None 

Others: FPST = nine-bytes at HL pushed onto the stack 

Registers All 
destroyed: 

Remarks: The previous FPST is now entry FPS1 . See PushRealOl , PushOPI . See the 

Floating Point Stack section. 

Example: 
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PushRealOl, PushReal02, PushReal03, PushReal04, 
PushReal05, PushReal06 

Category: Floating Point Stack 

Description: This description covers six entry points that are similar. The description is 
given for PushRealOl . The inputs/outputs are the same for the other five 
routines replacing OP1 with either OP2, OP3, OP4, OP5 or OP6. 

Pushes a new entry onto the FPS and copy the nine-bytes at OP1 into the new 
entry. No checks are made on the data that is put onto the stack. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = nine-bytes to push onto the FPS 
Outputs: 

Registers: None 
Flags: None 

Others: FPST = nine-bytes at OP1 pushed onto the stack 

Registers 
destroyed: 

Remarks: The previous FPST is now entry FPS1 . See PushReal, PushOPI . See the 

Floating Point Stack section. 

Example: 
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5 



System Routines — 
Graphing and Drawing 



AIIEq IsTI 



BufClr 15-21 



BufCpy [5J3 



CircCmd 5-4 



CircCmd (continued) |5-5 



ClearRect 5-6 



CLine 5-7 



CLine (continued) 5-8 



CLineS 5-9 



CLineS (continued) |5-10| 



ClrGraphRef |5-11[ 



CPoint 5-12 



CPoint (continued) 15-13 



CPointS 5-14 



CPointS (continued) 15-15 



DarkLine 5-16 



DarkLine (continued) |5-17 



DarkPnt 5-18 



DarkPnt (continued) |5-19 



Disp 1 5-20 



DrawCirc2 5-21 



DrawCirc2 (continued) |5-22 



DrawCmd 5-23 



DrawRectBorder 5-24 



DrawRectBorderClear 5-25 



EraseRectBorder 5-26 



FillRect 5-27 
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FillRect (continued) 5-28 



FillRectPattern 5-29 



FillRectPattern (continued) |5-30 



GrBufClr 5-31 



GrBufCpy |5-32 



GrphCirc |5-33 



HorizCmd 5-34 



IBounds 5-35 



IBoundsFull 5-36 



ILine 5-37 



ILine (continued) |5-38 



InvCmd 5-39 



InvertRect 5-40 



lOffset 5-41 



IPoint 5-42 



I Point (continued) I5-43 



LineCmd 5-44 



LineCmd (continued) 5-45 



PDspGrph [5^46 



PixelTest 5-47 



PointCmd 5-48 



PointCmd (continued) 5-49 



PointOn 5-50 



Regraph |5-51 



SetAIIPIots 5-52 



SetFuncM 5-53 



SetParM 5-54 



SetPolM 5-55 



SetSeqM |5-56 



SetTblGraphDraw 5-57 



TanLnF 5-58 



UCLineS 5-59 
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UnLineCmd 5-61 



VertCmd 5-62 



VtoWHLDE 5-63 



Xftol 5-64 



Xitof 5-65 



Yftol 5-66 



ZmDecml 5-67 



ZmFit 5-68 



Zmlnt 5-69 



ZmPrev 5-70 



ZmSquare |5-71 



ZmStats 5-72 



ZmTrig 5-73 



ZmUsr 5-74 



ZooDefault 5-75 
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AIIEq 



Category: Graphing and Drawing 

Description: Select or deselect all graph equations in the current graph mode. 
Inputs: 

Registers: ACC = 3 to select all equations in the current graph mode 

= 4 to deselect all equations in the current graph mode 

Flags: Current graph mode: IY + grfModeFlags = flag byte 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: All graph equations for the current mode are selected or deselected. 

Registers All 
destroyed: 

RAM used: OP1.0P2 

Remarks: 

Example: 
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BufClr 

Category: Graphing and Drawing 

Description: Executes the routine GrBufClr on a bitmap of the graph screen other than 
plotSScreen, the system graph backup buffer. 

Inputs: 

Registers: HL = pointer to start of graph buffer to clear, 768 bytes 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: RAM cleared. 

Registers All 
destroyed: 

Remarks: G-T and Horizontal modes will affect how much of the buffer is cleared. In 
order to have the entire buffer cleared set to full screen mode. 

There are two additional bit image display buffers allocated other than 
plotSScreen, they start at addresses appBackUpScreen and saveSScreen. 

Example: LD HL, appBackUpScreen 

B_CALL BufClr ; clear backup 
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BufCpy 



Category: Graphing and Drawing 

Description: Executes the routine GrBufCpy on a bitmap of the graph screen other that 
plotSScreen, the system graph backup buffer. The contents of the buffer are 
displayed. 

Inputs: 

Registers: HL = pointer to start of graph buffer to display, 768 bytes 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers All 
destroyed: 

Remarks: G-T and Horizontal modes will affect how much of the buffer is displayed. In 
order to have the entire buffer displayed, set to full screen mode. 

There are two additional bit image display buffers allocated other than 
plotSScreen, they start at addresses appBackUpScreen and saveSScreen. 

Example: LD HL, appBackUpScreen 

B_CALL BufCpy ; display backup buffer 
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CircCmd 

Category: 
Description: 

Inputs: 

Registers: 
Flags: 



Others: 



Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Displays the current graph screen and draws a circle on the graph screen 
given the center and the radius, relative to the current window settings. 



None 

useFastCirc, (IY + plotFlag3) = 1 for fast circle routine that draws the circle in 

sections simultaneously 
useFastCirc, (IY + plotFlag3) = 0 for normal circle routine that draws in a 

circular direction 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

FPST = radius, a floating-point number 

FPS1 = Y value of center, a floating-point number 

FPS2 = X value of center, a floating-point number 

The center specified is with respect to the current window settings. 



None 
None 

Current graph, and point operation are drawn to the screen and the graph 
backup buffer, plotSScreen. 

Inputs are removed from the Floating Point Stack. 

All 



If a zoom square is not done before using this routine the output circle will 
most likely not look circular but skewed in either the X or Y axis direction. 

If useFastCirc is used, the flag must be reset by the caller. 

(continued) 
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CircCmd (continued) 



Example: Execute a zoom standard and then draw a circle at (0,0) with radius 3 using 
the alternate fast circle draw. 



B_CALL 
B_CALL 
RST 
RST 



B_CALL 
RST 



SET 



B_CALL 

AppOf fErr 

RES 
RET 



ZooDef ault 
OPISetO 
rPushRealOl 
rPushRealOl 



OPlSet3 
rPushRealOl 



; standard window 
; OP1 = 0 

; (0,0) pushed 
; onto FPS 

radius is 3 
3 pushed onto 
FPS 



useFastCirc, ( IY+plotFlag3 ) ; fast circle 

; routine 



AppOnErr ClrFlag 



; set up error 

; handler to clear 

; fast circle flag 



CircCmd ; 

; remove no error 
useFastCirc, ( IY+plotFlag3 ) ; reset flag 



come here if error 
ClrFlag: 

RES 

r 

B_JUMP 



useFastCirc, ( IY+plotFlag3 ) ; reset flag 
JErrorNo 



; continue on with 
; system error 
; handle 
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ClearRect 



Category: 

Description: 

Inputs: 

Registers: 



Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Graphing and Drawing 

Clears a rectangular area on the screen (to Pixel off). 



H = upper left corner pixel row 
L = upper left corner pixel column 
D = lower right corner pixel row 
E = lower right corner pixel column 

plotLoc, (IY + plotFlags): 

0: update display and graph buffer 

1 : update display only 

None 



None 
None 
None 
All 



Rectangle is defined by pixel coordinates, where row = 0, column = 0 is upper 
left corner of screen and row = 63, column = 95 is lower right corner of screen. 

Area includes row and column of both coordinates. 
Inputs must satisfy conditions: D >= H, E >= L. 

Modifies saveSScreen RAM area. 



Make the whole screen 
black 



Clear the screen's top 
right quarter 
Get key press 
Exit app 



LD 


HL, OOOOh 


LD 


DE, 3F5Fh 


B_CALL 


FillRect 


LD 


H, 0 


LD 


L, 48 


LD 


D, 31 


LD 


E, 95 


B_CALL 


ClearRect 


B_CALL 


GetKey 


B_JUMP 


JForceCmdNoChar 
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CLine 



Category: 
Description: 



Inputs: 

Registers: 



Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 



Graphing and Drawing 

Draws a line between two points specified by graph coordinates. The line is 
plotted according to the current window settings Xmin, Xmax, Ymin, Ymax. 

The points do not need to lie within the current window settings this routine will 
clip the line to the screen edges if any portion of the line goes through the 
current window settings. 

This routine should only be used to draw lines in reference to the window 
settings. 

ILine can be used to draw lines by defining points with pixel coordinates, 
which will be a faster draw. 



OP4 — Y1 -coordinate 
OP3 — X1 -coordinate 
OP2 — Y2-coordinate 
OP1 — X2-coordinate 

G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. 
See ForceFullScreen. 

grfSplit, (IY + sGrFlags) = 1 if horizontal split mode set 
vertSplit, (IY + sGrFlags) = 1 if graph-table split mode set 
grfSplitOverride, (IY + sGrFlags) = 1 to ignore split modes 
plotLoc, (IY + plotFlags) = 1 to draw to the display only 

= 0 to draw to display and plotSScreen buffer. 
bufferOnly, (IY + plotFlag3) = 1 to draw to plotSScreen buffer only. 

None 



None 
None 
None 
All 



OP1 -OP6 

This routine does not copy the graph buffer to the screen or invoke a regraph if 
needed. Use PDspGrph to make sure the graph in the screen is valid. 

(continued) 



TI-83 Plus Developer Guide 



5-7 



Third Release January 25, 2002 



System Routines — Graphing and Drawing 



CLine (continued) 
Example: 



Point 1 : 



Point 2: 



LD 

LD 
LD 

LDIR 
LD 



_CALL 
CALL 



B_CALL 
RET 



DB 
DB 



DB 
DB 



HL, Point_l 

DE, 0P3 
BC, 18 

HL, Point_2 

Mov90P10P2 
PushMCplxOl 

CLine 



0, 80h, 15h, 0,0,0,0,0,0 
0, 80h, 30h, 0,0,0,0,0,0 

0, 80h, 40h, 0, 0, 0, 0, 0, 0 
0, 80h, 60h, 0,0,0,0,0,0 



Draw a line between 
the points (1.5,3) 
& (4, 6) : 

point to (1.5,3) in 

ROM 



point to (4,6) in 
ROM 

OP1 = 4 OP2 = 6 



; draw the line 



1 . 5 

3 
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CLineS 



Category: 
Description: 



Inputs: 

Registers: 



Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 



Graphing and Drawing 

Draws a line between two points specified by graph coordinates. The line is 
plotted according to the current window settings Xmin, Xmax, Ymin, Ymax. 

The points do not need to lie within the current window settings this routine will 
clip the line to the screen edges if any portion of the line goes through the 
current window settings. 

This routine should only be used to draw lines in reference to the window 
settings. 

ILine can be used to draw lines by defining points with pixel coordinates, 
which will be a faster draw. 



FPS2 — Y1 -coordinate 
FPS3 — X1 -coordinate 
FPST — Y2-coordinate 
FPS1 — X2-coordinate 

plotLoc, (IY + plotFlags) = 1 to draw to the display only 

= 0 to draw to display and plotSScreen buffer 
bufferOnly, (IY + plotFlag3) = 1 to draw to plotSScreen buffer only 

G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this turn off the split screen modes. 
See ForceFullScreen. 



1 if horizontal split mode set 
1 if graph-table split mode set 
1 to ignore split modes 



grfSplit, (IY + sGrFlags) 
vertSplit, (IY + sGrFlags) 
grfSplitOverride, (IY + sGrFlags) 

None 



None 
None 
None 
All 



OP1 -OP6 

This routine does not copy the graph buffer to the screen or invoke a regraph if 
needed. Use PDspGrph to make sure the graph in the screen is valid. 

(continued) 
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CLineS (continued) 
Example: 



LD 



_CALL 
CALL 



HL, Point_l 

Mov90P10P2 
PushMCplxOl 



Draw a line between 
the points (1.5,3) 
& (4, 6) : 

point to (1.5,3) in 

ROM 

0P1 =1.5 0P2 = 3 
push 0P1 and then 
0P2 onto the FPS 



LD 



_CALL 
CALL 



HL, Point_2 

Mov90P10P2 
PushMCplxOl 



point to (4,6) in 
ROM 

OP1 = 4 OP2 = 6 
push OP1 and then 
OP2 onto the FPS 



Point 1 : 



Point 2: 



B_CALL 
RET 



DB 
DB 



DB 
DB 



CLineS 



0, 80h, 15h, 0,0,0,0,0,0 
0, 80h, 30h, 0,0,0,0,0,0 

0, 80h, 40h, 0, 0, 0, 0, 0, 0 
0, 80h, 60h, 0,0,0,0,0,0 



draw the line 



1 . 5 

3 
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ClrGraphRef 



Category: Graphing and Drawing 

Description: Clears all graph reference flags in the symtable and the temporary symtable. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: Graph reference reset 

Registers HL, DE, BC 
destroyed: 

Remarks: 

Example: B_CALL ClrGraphRef 
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CPoint 



Category: 
Description: 



Inputs: 

Registers: 



Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Turns on, turns off, or inverts a point in the display specified by graph 
coordinates. The point is plotted according to the current window settings: 
Xmin, Xmax, Ymin, Ymax. 

This routine should only be used to draw points in reference to the window 
settings. 

IPoint can be used to draw points by defining points with pixel coordinates, 
which causes a faster draw. 



ACC = what to do 
0: turn point off 
1 : turn point on 
2: invert point 

G-T and HORIZ split-screen modes affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. 
See ForceFullScreen. 



grfSplit, (IY + sGrFlags) 
vertSplit, (IY + sGrFlags) 
grfSplitOverride, (IY + sGrFlags) 
plotLoc, (IY + plotFlags) 



bufferOnly, (IY + plotFlag3) 



1 if horizontal split mode set 
1 if graph-table split mode set 
1 to ignore split modes 
1 to draw to the display only 

0 to draw to display and plotSScreen 
buffer 

1 to draw to plotSScreen buffer only 



X Coordinate of point 
Y Coordinate of point 



OP1 
OP2 



None 
None 
None 



All 

This routine does not copy the graph buffer to the screen or invoke a regraph if 
needed. Use PDspGrph to make sure the graph in the screen is valid. 

(continued) 
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CPoint (continued) 

Example: Draw a point in the graph window at coordinates (1 .5,3): 

LD HL,Point_l ; point to (1.5,3) 

B_CALL Mov90P10P2 ; OP1 = 1.5 OP2 = 3 

t 

LD A, 1 ; turn on 

B_CALL CPoint ; draw the point 



Point_l : 



RET 



DB 0, 80H, 15H, 0, 0, 0, 0, 0, 0 ; 1.5 

DB 0, 80H, 30H, 0, 0, 0, 0, 0, 0 ; 3 
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CPointS 

Category: 
Description: 



Inputs: 

Registers: 

Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Turns on, turns off or inverts a point in the display specified by graph 
coordinates. The point is plotted according to the current window settings: 
Xmin, Xmax, Ymin, Ymax. 

This routine should only be used to draw points in reference to the window 
settings. 

IPoint can be used to draw points by defining points with pixel coordinates, 
which causes a faster draw. 



ACC = what to do 
0: turn point off 
1 : turn point on 
2: invert point 

G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. 
See ForceFullScreen. 



grfSplit, (IY + sGrFlags) 
vertSplit, (IY + sGrFlags) 
grfSplitOverride, (IY + sGrFlags) 
plotLoc, (IY + plotFlags) 



bufferOnly, (IY + plotFlag3) 

FPS1 — X Coordinate of point 
FPST — Y Coordinate of point 



1 if horizontal split mode set 
1 if graph-table split mode set 
1 to ignore split modes 
1 to draw to the display only 

0 to draw to display and plotSScreen 
buffer 

1 to draw to plotSScreen buffer only 



None 
None 
None 



All 

This routine does not copy the graph buffer to the screen or invoke a regraph if 
needed. Use PDspGrph to make sure the graph in the screen is valid. 

(continued) 
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CPointS (continued) 

Example: Draw a point in the graph window at coordinates (1 .5,3) 



LD 



_CALL 
_CALL 



HL, Point_l 

Mov90P10P2 
PushMCplxOl 



point to (1.5,3) 
in ROM 

OP1 =1.5 OP2 = 3 
push OP1 and then 
OP2 onto the FPS 



Point_l : 



LD 

B_CALL 
RET 

DB 
DB 



A,l 

CPointS 



; turn on 

; draw the point 



0, 80H, 15H, 0, 0, 0, 0, 0, 0 ; 1.5 
0, 80H, 30H, 0, 0, 0, 0, 0, 0 ; 3 
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DarkLine 

Category: 

Description: 

Inputs: 



Registers: 



Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Draws a line between two pixel points defined by their pixel coordinates. 

The graph window is defined with the lower left corner of the display to be pixel 
coordinate (0,0). 

The system graphing routines do not normally draw in the last column and the 
bottom row of the screen, column 95 and row 0. 

This routine can be made to use column 95 and row 0 by setting the flag: 
fullScrnDraw, (IY + apiFlg4) 

X = column 
Y = row 

B = X-coordinate of first point — 0...94 (95) see above 

C = Y-coordinate of first point — 1 (0)...63 

D = X-coordinate of second point — 0...94 (95) 

E = Y-coordinate of second point — 1 (0)...63 

fullScrnDraw, (IY + apiFlg4) = 1 to use column 95 and row 0 

plotLoc, (IY + plotFlags) = 1 to draw to the display only 

= 0 to draw to display and plotSScreen buffer 

bufferOnly, (IY + plotFlag3) = 1 to draw to plotSScreen buffer only 

None 



None 
None 

Line drawn where specified. 
All registers are preserved. 



If the draw is going to the buffer then the contents of the buffer are used to 

draw the line and copied to the screen. 

No clipping, X, Y points assumed to be defined on the screen. 

G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. 
See ForceFullScreen. 

(continued) 
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DarkLine (continued) 



Examplei ; Clear the screen. 

; Draw a line in the display only, between pixel coordinates (25,30) 
; and (62, 50) : 

B_CALL ClrLCD 

BC, 25*256+30 



LD 
LD 



DE, 62*256+50 



clear the screen; 
1st point, B = 25, 

C = 30 

2nd point, D = 62, 
E = 50 



SET plotLoc, (IY+plotFlags) 

B CALL DarkLine 



; display only 
; draw the line 
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DarkPnt 



Category: 
Description: 



Inputs: 

Registers: 
Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Turns on a point in the display specified by graph coordinates. 
The point is plotted according to the current window settings: 
Xmin, Xmax, Ymin, Ymax. 

This routine should only be used to draw points in reference to the window 
settings. 

IPoint can be used to draw points by defining points with pixel coordinates, 
which causes a faster draw. 



None 

G-T and HORIZ split screen modes affect how this routine maps the 
coordinates specified. To avoid this, turn off the split-screen modes. 
See ForceFullScreen. 



grfSplit, (IY + sGrFlags) 
vertSplit, (IY + sGrFlags) 
grfSplitOverride, (IY + sGrFlags) 
plotLoc, (IY + plotFlags) 



bufferOnly, (IY + plotFlag3) 



1 if horizontal split mode set 
1 if graph-table split mode set 
1 to ignore split modes 
1 to draw to the display only 

0 to draw to display and plotSScreen 
buffer. 

1 to draw to plotSScreen buffer only 



OP1 
OP2 



None 
None 
None 
All 



X Coordinate of point 
Y Coordinate of point 



This routine does not copy the graph buffer to the screen or invoke a regraph, 
if needed. Use PDspGrph to make sure the graph in the screen is valid. 

(continued) 
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DarkPnt (continued) 

Example: Draw a point in the graph window at coordinates (1 .5,3): 

LD HL,Point_l ; point to (1.5, 3) 

; in ROM 

B_CALL Mov90P10P2 ; OP1 =1.5 OP2 = 3 



Point_l : 



B_CALL DarkPnt ; draw the point 
RET 

DB 0, 80h, 15h, 0, 0, 0, 0, 0, 0 ; 1.5 

DB 0, 80h, 30h, 0, 0, 0, 0, 0, 0 ; 3 
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Disp 



Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Checks if graph screen is in the display. If it is, restores the text shadow to the 
screen. 



None 
None 
None 

None 

shiftFlags, textFlags 
curRow, curCol, winTop 
All 

This is intended to be used when an application uses both the home screen 
and the graph screen. 

Using this routine allows the application to switch between the home screen 
and the graph screen without having to rebuild the home screen. 

When switching to the graph screen, all of the text previously written to the 
home screen should have been also written to the text shadow. 

The plotLoc flag should be set when switching to the graph screen. 



Example: 
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DrawCirc2 



Category: 
Description: 



Inputs: 

Registers: 
Flags: 

Others: 



Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Draws a circle given the center and the radius, relative to the current window 
settings. 

The current graph screen is not put into the display by this routine. 
This icircle routine is one of two available, and is the faster of the two. 



None 

plotLoc, (IY + plotFlags) = 1 to draw to the display only 
plotLoc, (IY + plotFlags) = 0 to draw to display and buffer 
bufferOnly, (IY + plotFlag3) = 1 to draw to buffer only 

FPST = radius, a floating-point number 

FPS1 = Y value of center, a floating-point number 

FPS2 = X value of center, a floating-point number 

The center specified is with respect to the current window settings. 



None 
None 

Circle is drawn either to the display, the buffer, or both. 
Inputs are removed from the Floating Point Stack. 
All 

If a zoom square is not done before using this routine the output circle will 
most likely not look circular but skewed in either the X or Y axis direction. 
See CircCmd. See Floating Point Stack section. 

(continued) 
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DrawCirc2 (continued) 



Example: 



Execute a zoom standard and then draw a circle at (0,0) with radius 3. 



_CALL 
_CALL 



B_CALL 

RST 

RST 

B_CALL 
RST 

AppOnErr 
B_CALL 
AppOf fErr 
RET 



ZooDefault ; standard window 

PDspGrph ; get current graph to the 

; display 

OPISetO ; OP1 = 0 
rPushRealOl 

rPushRealOl ; (0,0) pushed onto FPS 

OPlSet3 ; radius is 3 

rPushRealOl ; 3 pushed onto FPS 



ciroerr 



DrawCirc2 



; set up error handler 



; remove no error 



come here if error 
Circerr : 
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DrawCmd 



Category: Graphing and Drawing 

Description: Displays the current graph screen and draws a function on it. Same as 
TI-83 Plus instruction DrawF. 

Inputs: 

Registers: None 

Flags: graphDraw, (IY + graphFlags) = 1 if current graph is dirty and needs to be 

redrawn 

= 0 if graph buffer is up to date and is copied 
to the screen 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

Others: FPST = name of equation to evaluate and draw, with X being the independent 
variable. 

Outputs: 

Registers: None 
Flags: None 

Others: Current graph and function are drawn to the screen and the graph backup 
buffer, plotSScreen. 

FPST = name of equation drawn, this must be cleaned by the calling routine. 
All 

OP1 -OP6 

Errors can be generated during the draw, see Error Handlers section. 
See section on Floating Point Stack 

Draw Y1 on the graph screen. 



Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



LD 


HL, Ylname 






B_CALL 


Mov9ToOPl 


; OP1 = Yl 




B_CALL 


PushRealOl 


; push Yl into 


FPST 


B_CALL 


DrawCmd 


; draw 




B_CALL 


PopRealOl 


; clean Yl off 


of FPS 
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DrawRectBorder 



Category: 

Description: 

Inputs: 

Registers: 



Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Draws a rectangular outline on the screen. 



H = upper left corner pixel row 
L = upper left corner pixel column 
D = lower right corner pixel row 
E = lower right corner pixel column 

plotLoc, (IY + plotFlags): 

0: update display and graph buffer 

1 : update display only 

None 



None 
None 
None 
All 



Rectangle is defined by pixel coordinates, where row = 0, column = 0 is the 
upper left corner of screen and row = 63, column = 95 is the lower right corner 
of screen. 

Area includes row and column of both coordinates. 
Inputs must satisfy conditions: D >= H, E >= L 

Modifies saveSScreen RAM area. 



Example: 



LD 
LD 



CALL 



B_CALL 
B JUMP 



HL, OOOOh 
DE, 3F5Fh 
DrawRectBorder 

GetKey 

JForceCmdNoChar 



Draw an outline around 
the screen 
Get key press 
Exit app 
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DrawRectBorderClear 



Category: 
Description: 

Inputs: 

Registers: 



Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Draws a rectangular outline on the screen and clears the area inside the 
outline. 



H = upper left corner pixel row 
L = upper left corner pixel column 
D = lower right corner pixel row 
E = lower right corner pixel column 

plotLoc, (IY + plotFlags): 

0: update display and graph buffer 

1 : update display only 

None 



None 
None 
None 
All 



Rectangle is defined by pixel coordinates, where row = 0, column = 0 is the 
upper left corner of screen and row = 63, column = 95 is the lower right corner 
of screen. 

Area includes row and column of both coordinates. 
Inputs must satisfy conditions: D >= H, E >= L. 

Modifies saveSScreen RAM area. 



Example: 



B_CALL 

LD 

LD 

LD 

LD 

B CALL 



CALL 



LD 
LD 



CALL 



B_CALL 
B JUMP 



ClrLCDFull 
H, 32 
L, 48 

D, 63 

E, 95 

FillRect 

GetKey 
HL, OOOOh 
DE, 3F5Fh 

DrawRectBorderClear 



GetKey 

JForceCmdNoChar 



Blacken the screen's 
lower right quarter 
Get key press 



Draw an outline 
around the screen and 
clear inside 
Get key press 
Exit app 
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EraseRectBorder 



Category: 

Description: 

Inputs: 

Registers: 



Flags: 

Others: 

Outputs: 

Registers: 

Flags 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Erases a rectangular outline on the screen (to white). 



H = upper left corner pixel row 
L = upper left corner pixel column 
D = lower right corner pixel row 
E = lower right corner pixel column 

plotLoc, (IY + plotFlags): 

0: update display and graph buffer 

1 : update display only 

None 



None 
None 
None 
All 



Rectangle is defined by pixel coordinates, where row = 0, column = 0 is the 
upper left corner of screen and row = 63, column = 95 is the lower right corner 
of screen. 

Area includes row and column of both coordinates. 
Inputs must satisfy conditions: D >= H, E >= L 

Modifies saveSScreen RAM area. 



Example: 



LD 


HL, OOOOh 




LD 


DE, 3F5Fh 




B_CALL 


DrawRect Border 


; Draw an outline around the 






; screen 


B_CALL 


GetKey 


; Get key press 


B_CALL 


EraseRectBorder 


; Erase an outline around 






; the screen 


B_CALL 


GetKey 


; Get key press 


B_JUMP 


JForceCmdNoChar 


; Exit app 
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FillRect 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Fills a rectangular area on the screen (to black). 



H = upper left corner pixel row 
L = upper left corner pixel column 
D = lower right corner pixel row 
E = lower right corner pixel column 

plotLoc, (IY + plotFlags): 

0: update display and graph buffer 

1 : update display only 

None 



None 
None 
None 
All 



Rectangle is defined by pixel coordinates, where row = 0, column = 0 is the 
upper left corner of screen and row = 63, column = 95 is the lower right corner 
of screen. 

Area includes row and column of both coordinates. 
Inputs must satisfy conditions: D >= H, E >= L 

Modifies saveSScreen RAM area. 

(continued) 
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FillRect (continued) 

Example: 



B_CALL ClrLCDFull 

LD HL, lC2Ch 

LD DE,2232h 

B_CALL FillRect 

B_CALL GetKey 

LD H, 0 

LD L, 0 

LD D,63 

LD E,95 

B_CALL InvertRect 

B_CALL GetKey 

LD H,0000h 

LD D,3F5Fh 

B_CALL InvertRect 

B_CALL GetKey 

B JUMP Jf orceCmdNoChar 



; Clear the whole screen 



; Put black square in 
; screen center 
; Get key press 



Turn to white square on 
black background 
Get key press 



Return to black square on 
white background 
Get key press 
Exit app 
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FillRectPattern 



Category: 

Description: 

Inputs: 

Registers: 



Flags: 



Others: 



Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Fills a rectangular area on the screen with a pattern. 



H = upper left corner pixel row 
L = upper left corner pixel column 
D = lower right corner pixel row 
E = lower right corner pixel column 

plotLoc, (IY + plotFlags): 

0: update display and graph buffer 

1 : update display only 



RectFillPHeight 
RectFillPWidth = 
RectFillPattern = 



pattern's height in pixel rows (byte, 1 - 8) 
pattern's width in pixel columns (byte, 1 - 8) 
one-byte for each pattern pixel row 

Pattern is right justified — bit 0 is right-most pixel in pattern row. First byte is 
the top row of the pattern. 



None 
None 
None 
All 



Rectangle is defined by pixel coordinates, where row = 0, column = 0 is upper 
left corner of screen and row = 63, column = 95 is lower right corner of screen. 

Area includes row and column of both coordinates. 
Inputs must satisfy conditions: D H, E L. 

You should not use the right-most column (95). This routine fails if you try to 
use it. 

Modifies saveSScreen RAM area. 

The pattern is written across the screen and is truncated at the right edge of 
the specified rectangle. The pattern will also be truncated at the bottom of the 
rectangle if needed. 

(continued) 
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FillRectPattern (continued) 

Example: b_call cirLCDFuii 

LD A, 6 

LD (ReotFillPHeight) , 
A 

LD A, 4 

LD (ReotFillPWidth) , A 

LD HL,MyPattern 

LD DE, RectFillPattern 

LD BC, 6 
LDIR 

LD HL, lF2Fh 

LD DE, 3F5Eh 



B_CALL FillRectPattern 

B_CALL GetKey 

B_JUMP JForceCmdNoChar 

MyPattern: DB OFh, 07h, 03h, Olh, 



; Clear the whole screen 

; Pattern is 6 pixels 

; high 

; Pattern is 4 pixels 

; wide 

; Copy source is the 

; pattern in this code 

; Copy destination is the 

; pattern buffer 

; Copy 6 bytes 

; Copy pattern to pattern 

; buffer 

; Coordinates of the full 

; screen except last 

; column 

; Fill it with the 

; pattern 

; Get key press 

; Exit app 
03h, 07h 
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GrBufClr 

Category: Graphing and Drawing 

Description: Clears out the graph backup buffer plotSScreen. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: All 768 bytes of plotSScreen set to 0. 

Registers All 
destroyed: 

Remarks: 

Example: 
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GrBufCpy 



Category: Graphing and Drawing 

Description: Copies the graph backup buffer plotSScreen to the display. 
Inputs: 

Registers: None 

Flags: None 

Others: (winBtm) should be = 8 
Outputs: 

Registers: None 

Flags: None 

Others: Graph buffer sent to display. 

Registers All 
destroyed: 

Remarks: Both vertical and horizontal split setting will affect what is copied to the screen. 
See ForceFullScreen. See RestoreDisp. 

Example: 
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GrphCirc 



Category: 
Description: 

Inputs: 

Registers: 
Flags: 



Others: 



Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Draws a circle on the screen given the pixel coordinates of the center and a 
point on the circle. 



None 

useFastCirc, (IY + plotFlag3) = 1 for fast circle routine that draws the circle in 

sections simultaneously 

useFastCirc, (IY + plotFlag3) = 0 for normal circle routine that draws in a 

circular direction 

plotLoc, (IY + plotFlags) = 1 to draw to the display only 
plotLoc, (IY + plotFlags) = 0 to draw to display and buffer 
bufferOnly, (IY + plotFlag3) = 1 to draw to buffer only. 

Pixel coordinates for the center and a point on the circle. Coordinate (0,0) is 
the pixel in the lower left corner of the display, (x,y). 

(curGX2) = x coordinate of center 
(curGY2) = y coordinate of center 

(curGX) = x coordinate of point on the circle 
(curGY) = y coordinate of point on the circle 

None 
None 

Circle drawn on the display. 
All 

The graph screen does not have to be displayed. The current window settings 
have no affect. If useFastCirc is used, the flag must be reset by the caller. See 
CircCmd and DrawCirc2 routines. 



Example: 
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HorizCmd 

Category: Graphing and Drawing 

Description: Displays the current graph screen and draws a horizontal line at X = OP1 . 
Same as TI-83 Plus instruction Horizontal. 

Inputs: 

Registers: None 

Flags: graphDraw, (IY + graphFlags) = 1 if current graph is dirty, and needs to be 

redrawn 

= 0 if graph buffer is up to date and is copied to 
the screen. 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

Others: OP1 = X value to draw the horizontal line at. 
Outputs: 

Registers: None 
Flags: None 

Others: Current graph and the line are drawn to the screen and the graph backup 
buffer, plotSScreen. 

FPST = name of equation drawn, this must be cleaned by the calling routine. 

Registers All 
destroyed: 

RAM used: OP1 -OP6 
Remarks: 

Example: Draw a horizontal line at X = 3 on the graph screen. 

B_CALL OP 1 Set 3 ; OP1 = 3 

B_CALL HorizCmd ; draw the line 
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IBounds 



Category: 
Description: 

Inputs: 

Registers: 

Flags: 
Others: 
Outputs: 

Registers: 
Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Tests if a pixel coordinate lies within the graph window defined by the current 
split mode settings. 



B = X pixel coordinate 
C = Y pixel coordinate 

The current split screen setting. 

None 

None 

CA = 1 if out of graph window 
= 0 if in graph window 

Line drawn where specified. 

All registers are preserved. 

G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. See 
ForceFullScreen and IBoundsFull routines for further information. 



Example: 
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IBoundsFull 



Category: 
Description: 



Inputs: 

Registers: 

Flags: 
Others: 
Outputs: 

Registers: 
Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Tests if a pixel coordinate lies within the full pixel range of the display. Full 
screen mode should be active when using this routine. Valid values will include 
all 64 rows and 96 columns of the display. Normally only 63 rows and 95 
columns are valid. 



B = X pixel coordinate 
C = Y pixel coordinate 

The current split screen setting. 

None 

None 

CA = 1 if out of graph window 
= 0 if in graph window 

Line drawn where specified. 

All registers are preserved. 

G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. See the 
ForceFullScreen and IBounds routines for further information. 
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ILine 



Category: Graphing and Drawing 

Description: Draws a line between two-pixel points defined by their pixel coordinates. 
The line drawn can be on, off, or inverted. 

Inputs: The graph window is defined with the lower left corner of the display to be pixel 

coordinates (0,0). 

The system graphing routines do not normally draw in the last column and the 
bottom row of the screen, column 95 and row 0. 

This routine can be made to use column 95 and row 0 by setting the flag: 
fullScrnDraw, (IY + apiFlg4) 

Registers: X = column 
Y = row 

B — X Coordinate of first point — 0...94 (95) see above 

C — Y Coordinate of first point — 1 (0)...63 

D — X Coordinate of second point — 0...94 (95) 

E — Y Coordinate of second point — 1 (0)...63 

H — Type of line to draw 

0 — Set points to light, on-line 

1 — Set points to dark 

2 — Invert points (XOR operation) 



Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 



fullScrnDraw, (IY + apiFlg4) 
plotLoc, (IY + plotFlags) 

bufferOnly, (IY + plotFlag3) 
None 

None 
None 

Line drawn where specified. 
All registers are preserved. 



1 to use column 95 and row 0 
1 to draw to the display only 

0 to draw to display and plotSScreen buffer 

1 to draw to plotSScreen buffer only 



(continued) 
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ILine (continued) 



Remarks: 



Example: 



If the draw is going to the buffer, then the contents of the buffer are used to 
draw the line and copied to the screen. 

G-T and HORIZ split-screen modes affect how this routine maps the 
coordinates specified. To avoid this, turn off the split-screen modes. 
See ForceFullScreen. 

No clipping, X, Y points assumed to be defined on the screen. 

Erase a line in the display only, between pixel coordinates (25,30) and (62,50). 



LD 



BC, 25*256+30 



1st point, B=25, 
C=30 

2nd point, D=62, 
E=50 



LD 



DE, 62*256+50 



SET 



plotLoc, (IY+plotFlags) 



display only 



LD 



H, 0 



signal turn pixels 
off 

draw the line 



B_CALL 



ILine 
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InvCmd 

Category: 
Description: 



Inputs: 

Registers: 
Flags: 



Others: 
Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Graphing and Drawing 

Displays the current graph screen and draws a function along the Y-axis. 

The equation is evaluated with respect to X, but the value of X will range 
between Ymin and Ymax, and the result of each evaluation will be the X 
coordinate, and the Y coordinate will be the value of X. It is the same as 
switching X and Y, and having Y be the independent variable. But it is 
important to write the expression in terms of X. 

Same as TI-83 Plus instruction Drawlnv. 



None 

graphDraw, (IY + graphFlags) = 1 if current graph is dirty and needs to be 

redrawn 

= 0 if graph buffer is up to date and is copied 
to the screen 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

FPST = name of equation to evaluate and draw 



None 
None 

Current graph and function are drawn to the screen and the graph backup 
buffer, plotSScreen. 

FPST = name of equation drawn, this must be cleaned by the calling routine. 
All 

OP1 -OP6 

Errors can be generated during the draw — see Error Handlers section. 

See section on Floating Point Stack. 

Draw Y1 on the graph screen along the Y-axis. 



LD 



_CALL 
_CALL 

_CALL 

_CALL 



HL, Ylname 
Mov9ToOPl 
PushRealOl 

InvCmd 

PopRealOl 



OP1 = Yl 

push Yl into FPST 
draw 

clean Yl off of FPS 
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InvertRect 



Category: 
Description: 

Inputs: 

Registers: 



Flags: 
Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Graphing and Drawing 

Inverts a rectangular area on the screen (black pixels to white; white pixels to 
black). 



H = upper left corner pixel row 
L = upper left corner pixel column 
D = lower right corner pixel row 
E = lower right corner pixel column 

None 

plotLoc, (IY + plotFlags): 

0: update display and graph buffer 

1 : update display only 



None 
None 
None 
None 



Rectangle is defined by pixel coordinates, where row = 0, column = 0 is the 
upper left corner of screen and row = 63, column = 95 is the lower right corner 
of screen. 

Area includes row and column of both coordinates. 
Inputs must satisfy conditions: D H, E L. 

Modifies saveSScreen RAM area. 



Example: 



B_CALL 


ClrLCDFull 


; Cle 


ar the s 


creen 




LD 


HL, 0 


; HL 


= upper 


left 


corner 


LD 


DE, 3F5Fh 


; DE 


= lower 


right 


corner 


B_CALL 


InvertRect 


; Bla 


cken ent 


ire s 


creen 


LD 


HL, 2030h 


; HL 


= middle 


of s 


creen 


LD 


DE, 3F5Fh 


; DE 


= lower 


right 


corner 


B_CALL 


InvertRect 


; Whi 


ten lowe 


r right quadrant 


B_CALL 


GetKey 


; Get 


key pre 


ss 
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lOffset 



Category: 
Description: 



Graphing and Drawing 

Given a pixel location, computes the offset to add to the start address of the 
graph buffer to the byte in the buffer containing that pixel. 

Also returns the bit number in that byte for that pixel. 

Also computes the row and column commands to set the LCD driver to the 
display byte for that pixel. 



Inputs: 

Registers: 

Flags: 
Others: 
Outputs: 

Registers: 



Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



lower left pixel of the display. 



Pixel's row and column coordinate, (0,0) 
B — Column coordinate value, (0 - 95) 
C — Row coordinate value, (0 - 63) 

None 

None 



ACC = bit that corresponds to the pixel's location in the byte it resides in is set. 
For example, pixel (0,0) would return with ACC = 80h, bit 7 is set. 

HL = byte offset to add to the start address of the display buffer to the byte 
that contains the pixel's bit. 

(curXRow) = row command to send to the LCD driver for that pixel. 
(curY) = column command to send to the LCD driver for that pixel. 

None 

None 

All but DE 



Test if pixel (23,14) is set in the graph buffer plotSScreen. 



LD 


BC, 23*256+14 


BC = 23, 14 


B_CALL 


IOf f set 




LD 


DE, plotSScreen 


start of graph buffer 


ADD 


HL, DE 


add offset to byte with 






pixel 


AND 


(HL) 


and pixels bit with byte 






in buffer 


JR 


Z, Pixel_is_Of f 


jump if pixel is not set 






in buffer 



TI-83 Plus Developer Guide 



5-41 



Third Release January 25, 2002 



System Routines — Graphing and Drawing 



IPoint 



Category: 
Description: 



Inputs: 



Registers: 



Flags: 



Others: 
Outputs: 

Registers: 
Flags: 

Others: 

Registers 
destroyed: 



Graphing and Drawing 

Executes one of the following pixel operations without displaying the current 
graph screen: 

Turn Off 

Turn On 

Change (invert) 

Test 

Copy 

The pixels are addressed with the lower left corner of the display being pixel 
(0,0), (row.col) 

The system does not normally draw in the last column, and the bottom row of 
the screen, column 95 and row 0. 

This routine can be made to use column 95 and row 0 by setting the flag: 
fullScrnDraw, (IY + apiFlg4) 

B = pixel row address — 0...94 (95 if full screen) see above 
C = Y Coordinate of first point — 1 (0)...63 (64 if full screen) 
D = Function to perform 

0 — Turn point off 

1 — Turn point on 

2 — Invert point (XOR operation) 

3 — Test point 

4 — Copy a point from buffer to the display 

fullScrnDraw, (IY + apiFlg4) = 1 to use column 95 and row 0 

plotLoc, (IY + plotFlags) = 1 to draw to the display only 
plotLoc, (IY + plotFlags) = 0 to draw to display and buffer 

bufferOnly, (IY + plotFlag3) = 1 to draw to buffer only 

None 



None 

For option 3 (test) 

Z = 1 for point off 
Z = 0 for point on 

None 

None, except for option 3 (test) then all. 

(continued) 
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IPoint (continued) 



Remarks: The test option always tests the buffer not the display. This means that in 
order to use the test option the pixel tested must have been written to the 
graph buffer. 

If the buffer is specified then the contents of the buffer are used to draw/copy, 
not what is in the screen. 

G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this turn off the split screen modes. See 
ForceFullScreen. 

If G-T mode is set then this routine will turn on pixels if the display byte 
containing the center column of pixels is accessed. This is done to keep the 
center line in G-T drawn. 

Example: Turn on the point specified by pixel coordinates at (5,10). 

LD BC, 5*256+10 

LD D, 1 ; point on cmd 

B_CALL IPoint ; turn on the point 
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LineCmd 



Category: 
Description: 



Inputs: 

Registers: 
Flags: 



Others: 



Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

RAM used: 

Remarks: 



Graphing and Drawing 

Displays the current graph screen and draws a line defined by two points. 

These points are graph coordinates with respect to the current range settings. 
They do not have to be points on the screen. If they are not on the screen the 
line will still be drawn if it passes through the screen with the current range 
settings. 

Same as TI-83 Plus instruction Line(. 



None 

graphDraw, (IY + graphFlags) = 1 if current graph is dirty and needs to be 

redrawn 

= 0 if graph buffer is up to date and is copied to 
the screen 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

points (X1 , Y1 ) (X2, Y2), all are floating-point numbers 
FPST = Y2 COORDINATE 
FPS1 = X2 COORDINATE 
FPS2 = Y1 COORDINATE 
FPS3 = X1 COORDINATE 

See Floating Point Stack section. 



None 
None 

Current graph and line are drawn to the screen and the graph backup buffer, 
plotSScreen. 

Inputs are removed from the Floating Point Stack. 
All 

OP1 -OP6 

Errors can be generated during the draw. See Error Handlers section. See 
CLine and ILine to draw lines without graphing. See section on Floating Point 
Stack. 



(continued) 
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LineCmd (continued) 

Example: Draw a line on the current graph screen between (1 ,2) and (3,4) 



!_CALL 
i_CALL 


OPISetl 
PushRealOl 


; OP1 = XI 
; to FPS 




i_CALL 
i_CALL 


Plusl 

PushRealOl 


; OP1 = OP1 + 1, 
; to FPS 


= Yl 


i_CALL 
i_CALL 


Plusl 

PushRealOl 


; OP1 = OP1 + 1, 
; to FPS 


= X2 


i_CALL 
i_CALL 


Plusl 

PushRealOl 


; OP1 = OP1 + 1, 
; to FPS 


= Y2 


i_CALL 


LineCmd 


; copy graph to 
; draw line 


screen and 
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PDspGrph 



Category: 
Description: 

Inputs: 

Registers: 
Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Graphing and Drawing 

Tests if the graph of the current mode needs to be regraphed. If so, the graph 
is regraphed, otherwise copies plotSScreen to the display. 



None 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

Current graph window settings and equations 



None 
None 
None 
All 



G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this situation, turn off the split screen modes. 
See the ForceFullScreen routine for further information. 

Generate the current graph screen in the display. 

B_CALL PDspGrph 
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PixelTest 

Category: Graphing and Drawing 

Description: Tests a pixel in the graph buffer specified by pixel coordinates without copying 
the graph to the display. 

Inputs: Pixel coordinate (0,0), (row,col), is the upper left most pixel. 

FPST = Pixel coordinate's column value, a floating-point number 
(0 - 94) in full screen and horizontal split 
(0 - 46) in vertical split 

FPS1 = Pixel coordinate's row value, a floating-point number 
(0 - 62) in full screen 
(0 - 30) in horizontal split 
(0 - 50) in vertical split 

See Floating Point Stack section. 

Registers: None 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: Z = 1 for point off 
Z = 0 for point on 

Others: None 

Registers All 
destroyed: 

Remarks: 

Example: Test on the point specified by pixel coordinates at (5,1 0). 

LD BC, 5*256+10 

} 

B_CALL PixelTest ; test the point 
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PointCmd 



Category: 
Description: 



Inputs: 

Registers: 



Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

RAM used: 

Remarks: 



Graphing and Drawing 

Displays the current graph screen and executes one of the following point 
operations: 

Turn Off 

Turn On 

Change (invert) 

The point is defined by graph coordinates with respect to the current range 
settings. The point does not need to be on the screen, and if it is not, then 
nothing will be drawn. 

Same as TI-83 Plus instructions Pt-On(, Pt-Off(, Pt-Change(. 



ACC = point command 

0 = On 

1 = Off 

2 = Change 

graphDraw, (IY + graphFlags) = 1 if current graph is dirty and needs to be 

redrawn 

= 0 if graph buffer is up to date and is copied to 
the screen 



bufferOnly, (IY + plotFlag3) 



1 if draw to the backup buffer plotSScreen, not 
to the display 



Bit 5 of RAM location (OP1 + 2) MUST = 0 

FPST = Y coordinate of the point, a floating-point number 

FPS1 = X coordinate of the point, a floating-point number 



None 
None 

Current graph and point operation are drawn to the screen and the graph 
backup buffer plotSScreen. 

Inputs are removed from the Floating Point Stack. 

All 

OP1 -OP6 

Errors can be generated during the draw. See Error Handlers section. See 
CPoint, CPointS, and IPoint for point commands without graphing. 

(continued) 
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PointCmd (continued) 

Example: Invert point at coordinate (1 .5,2) 



LD 


HL, fp_lp5 


B_CALL 


Mov9ToOPl 


B_CALL 


PushRealOl 


B_CALL 


OPlSet2 


B_CALL 


PushRealOl 


LD 


A, 2 


B_CALL 


PointCmd 



; OP1 = X coordinate, 1.5 

; to FPS 

; OP1 = Y coordinate, 2, resets 

; bit 5 (OP1 + 2) 

; to FPS 

; command to invert 

; copy graph to screen and 

; invert point 
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PointOn 

Category: 

Description: 

Inputs: 



Registers: 



Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Graphing and Drawing 

Turns on a point specified by its pixel coordinates. 

The graph window is defined with the lower left corner of the display to be pixel 
coordinates (0,0). 

The system graphing routines do not normally draw in the last column and the 
bottom row of the screen, column 95 and row 0. 

This routine can be made to use column 95 and row 0 by setting the flag: 
fullScrnDraw, (IY + apiFlg4) 



X 
Y 



column 
row 



B — X Coordinate of first point — 0...94 (95) see above 
C — Y Coordinate of first point — 1 (0)...63 



fullScrnDraw, (IY + apiFlg4) 
plotLoc, (IY + plotFlags) 

bufferOnly, (IY + plotFlag3) 
None 



1 to use column 95 and row 0 
1 to draw to the display only 

0 to draw to display and plotSScreen buffer 

1 to draw to plotSScreen buffer only 



None 
None 
None 
D 



If the buffer is specified, then the contents of the buffer are used to draw the 
point. 

G-T and HORIZ split-screen modes affect how this routine maps the 
coordinates specified. To avoid this, turn off the split-screen modes. 

See ForceFullScreen. 

Turn on the point specified by pixel coordinates at (5,10): 

LD BC, 5*256+10 

t 

B_CALL PointOn ; turn on the point 
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Regraph 

Category: 
Description: 

Inputs: 

Registers: 
Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Graphing and Drawing 

Graphs any selected equations in the current graph mode along with any 
selected statplots. 



None 

smartGraphinv, (IY + smartFlags) = 1 to defeat smart regraphing feature 

and force all equations to be 
regraphed, not just new ones. 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, 

not to the display. 

Current graph equations 
Current window settings 



None 
None 

Graph redrawn to the display and backup buffer plotSScreen, or the 
plotSScreen only. 

All but AF 



G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. . To avoid this situation, turn off the split screen modes. 
See the ForceFullScreen routine for further information. Also, see the Smart 
Regraphing section. 

B_CALL Regraph 
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SetAIIPIots 

Category: Graphing and Drawing 
Description: Selects or deselects all statplots. 
Inputs: 

Registers: B = 0 to unselect 
B = 1 to select 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: If any plot's selection stat changes then the graph is marked dirty. 

Registers All 
destroyed: 

Remarks: 

Example: Turn off all stat plots. 

LD B, 0 

B_CALL SetAIIPIots 
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SetFuncM 

Category: Graphing and Drawing 

Description: Changes from current graph mode to function mode. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: Current flags saved with current mode, function mode flags and pointers set 
up. 

Registers A, BC, DE, HL 
destroyed: 

Remarks: 

Example: b_call SetFuncM 
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SetParM 

Category: Graphing and Drawing 

Description: Changes from current graph mode to parametric mode. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: Current flags saved with current mode. Parametric mode flags and pointer set 
up. 

Registers A, BC, DE, HL 
destroyed: 

Remarks: 

Example: b_call SetParM 
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SetPolM 

Category: Graphing and Drawing 

Description: Changes from current graph mode to polar mode. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: Current flags saved with current mode, polar mode flags and pointers set up. 

Registers A, BC, DE, HL 
destroyed: 

Remarks: 

Example: b_call setPoiM 
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SetSeqM 



Category: Graphing and Drawing 

Description: Changes from current graph mode to sequence mode. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: Current flags saved with current mode, sequence mode flags and pointers set 
up. 

Registers A, BC, DE, HL 
destroyed: 

Remarks: 

Example: b_call setseqM 
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SetTblGraphDraw 

Category: Graphing and Drawing 

Description: Sets the current graph to dirty to cause a complete regraph the next time the 
graph needs to be displayed. Also marks the table of values as dirty, unless a 
graph is currently being graphed. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: smartGraphinv, (IY + smartFlags) is set to invalidate smart graph 
reTable, (IY + tbIFIags) is set to dirty the table, if not graphing 
graphDraw, (IY + graphFlags) is set to dirty the graph 

Others: None 

Registers None 
destroyed: 

Remarks: 

Example: 
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TanLnF 



Category: 
Description: 



Inputs: 

Registers: 

Flags: 

Others: 



Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Graphing and Drawing 

Draws the tangent line for given equation at a given point. 

The equation itself is not drawn only the tangent line. 

The graph screen is not displayed — it is assumed to be displayed already. 



None 
None 

FPST = equation name, X is the independent variable 

Variable X = X coordinate of point 

OP1 = Y coordinate of point, a floating-point number 

Window settings for the current graph are used 



None 
None 

Tangent line drawn to the display. 
Equation name removed from the FPS. 
All 

OP1 -OP6 

See section on the Floating Point Stack in Chapter 2. 
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UCLineS 



Category: 
Description: 



Inputs: 

Registers: 



Flags: 



Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Graphing and Drawing 

Draws a WHITE line between two points specified by graph coordinates. 

The line is plotted according to the current window settings Xmin, Xmax, Ymin, 
Ymax. 

The points do not need to lie within the current window settings. This routine 
will clip the line to the screen edges if any portion of the line goes through the 
current window settings. 

This routine should only be used to draw lines in reference to the window 
settings. 

ILine can be used to draw lines by defining points with pixel coordinates, 
which will be a faster draw. 



FPS2 — Y1 Coordinate 
FPS3 — X1 Coordinate 
FPS1 — Y2 Coordinate 
FPST — X2 Coordinate 



plotLoc, (IY + plotFlags) 



bufferOnly, (IY + plotFlag3) = 



1 to draw to the display only 

0 to draw to the display and the plotSScreen 
buffer 

1 to draw to the plotSScreen buffer only 



G-T and HORIZ split screen modes will affect how this routine maps the 
coordinates specified. To avoid this, turn off the split screen modes. See the 
ForceFullScreen routine. 



grfSplit, (IY + sGrFlags) 
vertSplit, (IY + sGrFlags) 
grfSplitOverride, (IY + sGrFlags) 

None 



None 
None 
None 
All 



1 if horizontal split mode set 
1 if graph-table split mode set 
1 to ignore split modes 



OP1 -OP6 

This routine does not copy the graph buffer to the screen or invoke a regraph if 
needed. Use PDspGrph to make sure the graph in the screen is valid. 

See the CLineS routine. 
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UnLineCmd 



Category: 
Description: 



Inputs: 

Registers: 
Flags: 



Others: 



Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

RAM used: 

Remarks: 



Graphing and Drawing 

Displays the current graph screen and erases a line defined by two points. 

These points are graph coordinates with respect to the current range settings. 
They do not have to be points on the screen. If they are not on the screen, the 
line will still be drawn if it passes through the screen with the current range 
settings. 

Same as the TI-83 Plus instruction Line( with the last argument = 0 for unline. 



None 

graphDraw, (IY + graphFlags) = 1 if current graph is dirty and needs to be 

redrawn 

= 0 if graph buffer is up to date and is copied to 
the screen 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

Points (X1.Y1) (X2,Y2), all are floating-point numbers 
FPST = Y2 COORDINATE 
FPS1 = X2 COORDINATE 
FPS2 = Y1 COORDINATE 
FPS3 = X1 COORDINATE 

See the Floating Point Stack section. 



None 
None 

Current graph and line are drawn to the screen and the graph backup buffer, 
plotSScreen. 

Inputs are removed from the Floating Point Stack. 
All 

OP1 -OP6 

Errors can be generated during the draw — see the Error Handlers section. 
See UCLineS to draw lines without graphing. See the Floating Point Stack 
section. 



Example: 



See LineCmd. 
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VertCmd 

Category: Graphing and Drawing 

Description: Displays the current graph screen and draws a vertical line at Y = OP1 . 
Same as TI-83 Plus instruction Vertical. 

Inputs: 

Registers: None 

Flags: graphDraw, (IY + graphFlags) = 1 if current graph is dirty and needs to be 

redrawn 

= 0 if graph buffer is up to date and is copied to 
the screen 

bufferOnly, (IY + plotFlag3) = 1 if draw to the backup buffer plotSScreen, not 

to the display 

Others: OP1 = Y value to draw the vertical line at 
Outputs: 

Registers: None 
Flags: None 

Others: Current graph and the line are drawn to the screen and the graph backup 
buffer, plotSScreen. 

FPST = name of equation drawn, this must be cleaned by the calling routine. 

Registers All 
destroyed: 

RAM used: OP1 -OP6 
Remarks: 

Example: Draw a vertical line at Y = 3 on the graph screen. 

B_CALL OP 1 Set 3 ; OP1 = 3 

} 

B_CALL VertCmd ; draw the line 
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VtoWHLDE 



Category: 
Description: 



Inputs: 

Registers: 

Flags: 
Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Graphing and Drawing 

In the current graph window converts a pixel point to its corresponding X and Y 
values, floating-point numbers. 

The graph must be up to date for this routine to return correct values. 



B = X pixel value, 0 - 94, 0 = left most pixel column 

C = Y pixel value, 1 - 62, 1 = next to last row of pixels from bottom 

None 

None 



None 
None 

OP1 = floating-point value representing X pixel coordinate 
OP4 = floating-point value representing Y pixel coordinate 

All 

OP1, OP2, OP3, OP4 

The bottom row of pixels is not used. Graph is up to date. 
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Xftol 

Category: Graphing and Drawing 

Description: In the current graph window, converts a floating-point value to an X pixel 
coordinate. 

This is used by the graphing routines to plot points in the current graph. 
The graph must be up to date for this routine to return correct values. 

Inputs: 

Registers: HL = pointer to floating-point number representing the X coordinate 
Flags: None 
Others: None 
Outputs: 

Registers: ACC = X pixel value, 0 - 94, 0 = left most pixel column 

Flags: None 

Others: None 

Registers All 
destroyed: 

RAM used: OP1,OP2, OP3 

Remarks: The right most column is not used. Graph is up to date. 
Example: 
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Xitof 

Category: 
Description: 

Inputs: 

Registers: 

Flags: 
Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Graphing and Drawing 

In the current graph window converts an X pixel coordinate to the floating-point 
value of X for that pixel. 

The graph must be up to date for this routine to return correct values. 



ACC = X pixel value, 0 - 94, 0 = left most pixel column 
HL = pointer to location to return floating-point value 

None 

None 



None 
None 

Floating-point value representing X pixel coordinate returned at input HL to 
HL + 8. 

All 



OP1, OP2, OP3 

The bottom row of pixels is not used. Graph is up to date. 
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Yftol 

Category: Graphing and Drawing 

Description: In the current graph window, converts a floating-point value to an Y pixel 
coordinate. 

This is used by the graphing routines to plot points in the current graph. 
The graph must be up to date for this routine to return correct values. 

Inputs: 

Registers: HL = pointer to floating-point number representing the Y coordinate 
Flags: None 
Others: None 
Outputs: 

Registers: ACC = Y pixel value, 1 - 62, 1 = next to last row of pixels from bottom 

Flags: None 

Others: None 

Registers All 
destroyed: 

RAM used: OP1,OP2, OP3 

Remarks: The bottom row of pixels is not used. Graph is up to date. 
Example: 
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ZmDecml 

Category: Graphing and Drawing 

Description: Changes the window settings such that (0,0) is in the center of the display and 
=X and =Y = 0.1 . See the ZDecimal selection in the TI-83 Plus ZOOM menu. 

Inputs: 

Registers: None 
Flags: None 

Others: Current window settings. 
Outputs: 

Registers: None 

Flags: graphDraw, (IY + graphFlags) = 1 , dirty the graph 

Others: Current window settings are moved to ZPrevious. New windows settings set to 
X: -4.7 to 4.7, Y: -3.1 to 3.1 

Registers All 
destroyed: 

Remarks: The graph is marked dirty for redrawing, but the graph is not redrawn. 
Example: 
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ZmFit 

Category: Graphing and Drawing 

Description: Changes the window settings such that the minimum and maximum Y value 
for all selected functions fit in the graph window. 

The same ZoomFit under the ZOOM menu. 

Inputs: 

Registers: None 

Flags: None 

Others: Current window settings 
Outputs: 

Registers: None 

Flags: graphDraw, (IY + graphFlags) = 1 , dirty the graph 

Others: Current window settings are moved to ZPrevious. 

New windows settings set so that all selected functions Y values fit in the 
display when regraphed. 

Registers All 
destroyed: 

Remarks: The graph is marked dirty for redrawing, but the graph is not redrawn. 
Example: 
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Zmlnt 

Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Graphing and Drawing 

Changes the window settings such that AX and AY = 1 .0, given the 
coordinates in the center of the screen. The coordinates of the center of the 
screen are rounded to the closest integer before the window range is set. See 
the Zlnteger selection in the TI-83 Plus ZOOM menu. 

None 
None 

OP1 = X coordinate of new center of the screen, floating-point number 
OP5 = Y coordinate of new center of the screen, floating-point number 

Current window settings. 
None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 
Current window settings are moved to ZPrevious. 
New windows settings set. 
All 



The graph is marked dirty for redrawing, but the graph is not redrawn. 
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ZmPrev 

Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Graphing and Drawing 

Changes the window settings back to the settings before the last zoom 
command was executed, if one was. See the ZPrevious selection in 
TI-83 Plus ZOOM/MEMORY menu. 



None 
None 
None 



None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 

If ZPrevious values exist they are copied to the current window settings. 

All 

The graph is marked dirty for redrawing, but the graph is not redrawn. 
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ZmSquare 



Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Graphing and Drawing 

Changes the window settings in either the X or Y direction such that AX = AY. 
Doing this operation will make a circle drawn have the shape of a circle instead 
of an ellipse. See the ZSquare selection in the TI-83 Plus ZOOM menu. 



None 
None 
None 

None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 
Current window settings are moved to ZPrevious. 
New windows settings set. 
All 

The graph is marked dirty for redrawing, but the graph is not redrawn. 
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ZmStats 

Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Graphing and Drawing 

Changes the window settings such that all selected Statplots will be visible in 
the graph window. See the ZoomStat in the TI-83 Plus ZOOM menu. 



None 
None 
None 



None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 
Current window settings are moved to ZPrevious. 
New windows settings set. 
All 

The graph is marked dirty for redrawing, but the graph is not redrawn. 
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ZmTrig 



Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 



Graphing and Drawing 

Changes the window settings to preset values that are appropriate for 
trigonometrical function graphs. See the ZTrig selection in the TI-83 Plus 
ZOOM menu. 



None 
None 

Current window settings 
None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 



Registers 
destroyed: 

Remarks: 

Example: 



Current window settings are moved to ZPrevious. 
New windows settings set to X: -(47/24) * pi, Y: (47/24) 



Pi 



If the current angle mode setting is radians, then those values are used. If the 
current angle mode setting is degrees, then those values are converted from 
radians to degrees. 

All 

The graph is marked dirty for redrawing, but the graph is not redrawn. 
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ZmUsr 

Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Graphing and Drawing 

Recalls the window settings stored by the last ZoomSto command. See the 
ZoomRcl selection in the TI-83 Plus ZOOM/MEMORY menu. 



None 
None 
None 



None 

graphDraw, (IY + graphFlags) = 1 , dirty the graph 
Current window settings are moved to ZPrevious. 
New windows settings set. 
All 

The graph is marked dirty for redrawing, but the graph is not redrawn. 
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ZooDefault 

Category: Graphing and Drawing 

Description: Changes the window settings back to the default settings of (-10,10) for both X 
and Y ranges. 

The same ZStandard under the ZOOM menu. 

Inputs: 

Registers: None 
Flags: None 

Others: Current window settings 
Outputs: 

Registers: None 

Flags: graphDraw, (IY + graphFlags) = 1 , dirty the graph 

Others: New windows settings set to X: -1 0 to 1 0, Y: -1 0 to 1 0 

Registers All 
destroyed: 

Remarks: The graph is marked dirty for redrawing, but the graph is not redrawn. 
Example: 
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System Routines 
Interrupt 



DivHLBylO 6-1 



DivHLByA 6-2 
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DivHLBylO 

Category: Interrupt 

Description: Divides HL by 10. 
Inputs: 

Registers: HL = dividend 

Flags: None 

Others: None 

Outputs: 

Registers: HL = lnt(HL/10) 
A = mod(HL/10) 

Flags: None 

Others: None 

Registers None 
destroyed: 

Remarks: None 
Example: 
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DivHLByA 

Category: Interrupt 

Description: Divides HL by accumulator. 

Inputs: 

Registers: HL = dividend 
A = divisor 

Flags: None 

Others: None 

Outputs: 

Registers: HL = lnt(HL/A) 

A = mod(HL/A) (remainder) 

Flags: None 

Others: None 

Registers None 
destroyed: 

Remarks: None 
Example: 



TI-83 Plus Developer Guide 



6-2 



Third Release January 25, 2002 



System Routines - 10 



7 



System Routines 

10 



AppGetCalc |7-1| 

AppGetCbl |7j2| 

Red stByte [7^3 

RedstByteNC |74 

RecABytelO [7g 

SendAByte ffH 

SendVarCmd [77 
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AppGetCalc 



Category: 10 

Description: Executes the basic GetCalc command to retrieve a variable from another 
TI-83 Plus or a TI-83. 

Inputs: 

Registers: 0P1 = name of variable to attempt to retrieve 
Flags: None 
Others: None 
Outputs: 

Registers: None 
Flags: None 

Others: com Failed, (IY + getSendFIg) = 0 if variable received 

com Failed, (IY + getSendFIg) = 1 if variable not received 
Variable updated or created if received 

Registers All 
destroyed: 

Remarks: Variables can be received from both an TI-83 Plus and a TI-83. 
Example: 



B CALL 



CALL 



AnsName 



AppGetCalc 



BIT 
JP 



comFailed, ( IY+getSendFlg) 
NZ, GetFailed 



0P1 = Ans 
variable name 
attempt to get 
Ans 

did it work? 
jump if no 
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AppGetCbl 



Category: 10 

Description: Executes the basic GetCbl command to retrieve data from a CBL/CBL2 or 
CBR device. 

Inputs: 

Registers: 0P1 = name of variable to attempt to retrieve 

Flags: None 

Others: None 
Outputs: 

Registers: None 



Flags: 
Others: 



Registers 
destroyed: 

Remarks: 
Example: 



None 

com Failed, (IY + getSendFIg) = 0 if variable received 
com Failed, (IY + getSendFIg) = 1 if variable not received 
Variable updated or created if received 

All 



LD 

RST 



_CALL 



Llname : 



BIT 

JP 

DB 



HL, Llname 
rMov9ToOPl 

AppGetCbl 

comFailed, ( IY+getSendFlg) 
NZ, GetFailed 
ListObj,tVarLst,tLl, 0, 0 



0P1 = LI variable 
name 

attempt to get 
data 

did it work? 
jump if no 
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RedstByte 



Category: 10 

Description: Polls the link port for activity until either a byte is received, the [ON] key is 

pressed, or an error occurred during communications. The cursor is turned on 
for updates. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: ACC = byte received if one 
Flags: None 

Others: Error will be generated if communications fail. 

An error is also generated if the [ON] key is pressed. 

Registers All 
destroyed: 

RAM used: 

Remarks: APD can occur while waiting for link activity. See Chapter 2 for Error Handlers 
and Link Port. See entry points RedstByteNC, RecAByte, and SendAByte. 

Example: See Chapter 2. 
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RedstByteNC 



Category: 10 

Description: Polls the link port for activity until either a byte is received, the [ON] key is 

pressed, or an error occurred during communications. The cursor is not turned 
on for updates. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: ACC = byte received if one 
Flags: None 

Others: Error will be generated if communications fail. An error is also generated if the 
[ON] key is pressed. 

Registers All 
destroyed: 

RAM used: 

Remarks: APD can occur while waiting for link activity. See Chapter 2 for Error Handlers 
and Link Port. See entry points RedstByte, RecAByte, and SendAByte. 

Example: See Chapter 2. 
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RecABytelO 



Category: 10 

Description: Attempts to read a byte of data over the link port. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: ACC = byte if successful 

Flags: None 

Others: None 

Registers All 
destroyed: 

Remarks: If no link activity is detected within about 1 .1 seconds, a system error is 

generated. See entry points RedstByte, RedstByteNC, and SendAByte. 

Example: See Chapter 2. 
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SendAByte 



Category: 10 

Description: Attempts to send a byte of data over the link port. 
Inputs: 

Registers: ACC = byte to send. 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers All 
destroyed: 

Remarks: If no link activity is detected within about 1 .1 seconds, a system error is 

generated. See entry points RedstByte, RedstByteNC, and RecAByte. 

Example: See Chapter 2. 
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SendVarCmd 



Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



10 

Attempts to send a variable whose name is in 0P1 to CBL/CBL2 or CBR 
device. 



None 
None 

0P1 contains name of variable to send. 
None 

ComFailed, (lY+getSendFIg) = 1 if send failed. 
ComFailed, (lY+getSendFIg) = 0 if successful. 
0P1 is left intact. 
All 

No system error is generated if link is not successful. 
Check status of Channel 1 on CBL2. 



Createlt : 



Llname : 
Command8 : 



LD 

RST 
RST 
JR 

B_CALL 
LD 

B_CALL 

INC 

INC 

LD 

LD 

LDIR 

B_CALL 

B_CALL 

BIT 

JP 

B_CALL 

BIT 

JP 

DB 

DB 
DB 
DB 



HL, Llname 
rMov9ToOPl 
rFindSym 
C, Createlt 

DelVarArc 

HL, 3 

CreateRList 

DE 

DE 

HL, Command8 
BC, 27 

Op4ToOpl 
SendVarCmd 

comFailed, ( IY+getSendFlg) 
NZ, SendFailed 
AppGetCbl 

comFailed, ( IY+getSendFlg) 
NZ, GetFailed 

ListObj,tVarLst,tLl, 0, 0 

OOh, 80h, 80h, OOh, OOh, 
OOh, 80h, lOh, OOh, OOh, 
OOh, 80h, OOh, OOh, OOh, 



0P1 = LI name 

Look up LI 

jump if it doesn't 

exist 

delete LI 

3 elements in LI 
LI created 

move past size bytes 



LI = {8,1,0} 
OP1 = LI name 
send LI to CBL2 
did it work? 
no, jump 

attempt to get LI 
did it work? 
jump if no 



OOh, OOh, OOh, OOh 
OOh, OOh, OOh, OOh 
OOh, OOh, OOh, OOh 
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System Routines 
Keyboard 



ApdSetup 18-1 



CanAlphlns 8-2 



GetCSC 8-3 



GetKey 8-6 
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ApdSetup 

Category: Keyboard 

Description: Resets the Automatic Power Down timer. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: (apdTimer) 

Flags: None 

Others: None 

Registers HL 
destroyed: 

Remarks: 
Example: 
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CanAlphlns 



Category: Keyboard 

Description: Cancels alpha, alpha lock, and insert mode. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: textlnsMode (In textFlags) and shiftALock (In shiftFlags) cleared 

shiftAlpha (In shiftFlags) and shiftLwrAlph (In shiftFlags) may also be cleared 
depends on flag shiftKeepAlph (In shiftFlags) 

Others: None 

Registers None 
destroyed: 

Remarks: 

Example: B_CALL CanAlphlns 
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GetCSC 



Category: 
Description: 



Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 



Registers: 

Flags: 

Others: 

Registers 
destroyed: 



Keyboard 

Gets and clears keyboard scan code. This routine should be used to read the 
keyboard only when an app does not care about second keys or alpha keys or 
pull down menus. 

This routine only returns to the application which physical key on the keyboard 
was last pressed. 



None 
None 
None 

This routine does not wait for a key press to return back to the app. Key 
presses are detected in the interrupt handler, this routine returns that value. A 
0 value is returned if no key has been pressed since the previous call to 
GetCSC. 

A = (kbdScanCode) value 
None 

(kbdScanCode) set to 0. kbdSCR flag reset. 
AF, HL 

(continued) 
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GetCSC (continued) 

Remarks: No silent link activity will be detected if this routine is used to poll for keys. 
Below are the scan code equates. 



skDown 


equ 


01 h 


skCos 


equ 


1Eh 


skLeft 


equ 


02h 


skPrgm 


equ 


1 Fh 


skRight 


equ 


03h 


skStat 


equ 


20h 


skUp 


equ 


04h 


skO 


equ 


21 h 


skEnter 


equ 


09h 


ski 


equ 


22h 


skAdd 


equ 


OAh 


sk4 


equ 


23 h 


skSub 


equ 


OBh 


sk7 


equ 


24h 


skMul 


equ 


OCh 


skComma 


equ 


25h 


skDiv 


equ 


ODh 


skSin 


equ 


26h 


skPower 


equ 


OEh 


skMatrix 


equ 


27h 


skClear 


equ 


OFh 


skGraphvar 


equ 


28h 


skChs 


equ 


11 h 


skStore 


equ 


2Ah 


sk3 


equ 


12h 


skLn 


equ 


2Bh 


sk6 


equ 


13h 


skLog 


equ 


2Ch 


sk9 


equ 


14h 


skSquare 


equ 


2Dh 


skRParen 


equ 


15h 


skRecip 


equ 


2Eh 


skTan 


equ 


16h 


skMath 


equ 


2Fh 


skVars 


equ 


17h 


skAlpha 


equ 


30h 


skDecPnt 


equ 


19h 


skGraph 


equ 


31 h 


sk2 


equ 


1Ah 


skTrace 


equ 


32h 


sk5 


equ 


1Bh 


skZoom 


equ 


33h 


sk8 


equ 


1Ch 


skWindow 


equ 


34h 


skLParen 


equ 


1Dh 


skYEqu 


equ 


35h 








sk2nd 


equ 


36h 








skMode 


equ 


37h 








skDel 


equ 


38h 



(continued) 
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GetCSC (continued) 

Example: Poll for the 2nd key. 



sleep : 



EI 



HALT 



_CALL 



CP 
JR 



GetCSC 
ksk2nd 
NZ, sleep 



; enable interrupts 

; the halt is optional, this 

; will help save battery life. 

; you can still use GetCSC at 

; anytime without the halt. 



; sleep in low power for a 

; little 

; check for a scan code 

; 2nd key ? 

; jump if no 
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GetKey 



Category: 
Description: 



Inputs: 

Registers: 
Flags: 



Others: 
Outputs: 

Registers: 

Flags: 
Others: 



Registers 
destroyed: 

Remarks: 



Example: 



Keyboard 

Keyboard entry routine that will return second keys, alpha keys — both capital 
and lower case, the on key, APD, and link communication. Contrast 
adjustment is also handled by this routine. 

When called, this routine scans for keys until one is pressed, or an APD 
occurs, or the unit is turned off, or link activity is detected. 



None 

indicOnly, (IY + indicFlags) 



indicRun, (IY + indicFlags) 
apdAble, (IY + apdFlags) 



MUST BE RESET, otherwise no key presses 
will be detected. 

1 to show the run indicator while waiting for a 
key press. 
1 if APD is enabled 
= 0 if APD is disabled 
IwrCaseActive, (IY + appLwrCaseFlag) = 1 for the key sequence 

[alpha] [alpha] to access lower 
case alpha key presses 
= 0 for normal alpha key operation 

None 



ACC = key code, 0 = ON key 
See TI83plus.inc file. 

onlnterrupt, (IY + onFlags) = 1 if ON key, this should be reset 

APD: If the auto power down occurs the application will not be notified. Once 
the unit is turned back on control is returned to the GetKey routine. 

OFF: If the unit is turned off the application is put away. When the unit is 
turned back on the home screen will be in control. 

Link Activity: When link activity is initiated, control is given to the silent link 
handler. If the communication is from the GRAPH LINK, the 
application will be shut down in most cases. The only exception is 
getting screen snap shots, in that case the application is not shut 
down. After the screen is sent control returns to GetKey. 

DE, HL 

If APD is disabled, it should be re-enabled before exiting the application. If 
lower case is enabled, it should be disabled upon exiting the application. 
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9 



System Routines 

List 



AdrLEle [JM 

ConvDim [9^2 

ConvLcToLr [9^3 

ConvLrToLc [9~4 

DelListEl [9^5 

Find_Parse_Formula |9-6 

GetLToOPI [9^7 

IncLstSize WH 

IncLstSize (continued) [9^9 

InsertList |9-10 

InsertList (continued) 19-1 1 

PutToL 19-12 
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AdrLEle 



Category: 

Description: 

Inputs: 

Registers: 



Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



List 

Computes the RAM address of an element of a list. 



DE = pointer to start of list's data storage, output of FindSym 

HL = element number in list to compute address of. List element number one 

is checked for real or complex data type to determine if the list is real or 

complex. 

None 
None 



HL = pointer in RAM to the start of the desired element 

None 

None 

AF, BC 



This routine does not check to see if the element's address requested is within 
the current size of the list. 

Do not use this routine on a list that does not have element number 1 
initialized. 

Compute the address of element number 23 of list L1 . 



LD 
RST 

B_CALL 
JP 

LD 

OR 
JP 



HL, LIName 

rMov9ToOPl 

FindSym 

C, Undef inedLl 

A, B 



OP1 = LI name 
look it up 

jump out if LI is not 
defined; 

if b<>0 then LI is archived 
in Flash ROM 

; jump if not in RAM 



NZ, ArchivedLl 
; DE = pointer to start of list data storage; 

LD HL,23d ; element's address desired 

B_CALL AdrLEle ; RET HL = pointer to 23rd 

; element 

RET 

LIName : 

DB ListObj,tVarLst,tLl, 0, 0 
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ConvDim 

Category: List 

Description: Converts floating-point value in OP1 to a two-byte hex value — make sure 
valid matrix or vec dimension. Less than 1 00 is valid dimension 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = FP number 
Outputs: 

Registers: A = LSB HEX VALUE, DE = ENTIRE HEX VALUE 

Flags: None 

Others: None 

Registers A, BC, DE, HL, OP1 
destroyed: 

Remarks: Error if negative, non-integer, or greater than 99. 

Example: B_CALL ConvDim 
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ConvLcToLr 

Category: List 

Description: Converts an existing complex list variable to a real list variable. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = name of complex list variable to convert 
Outputs: 

Registers: None 
Flags: None 

Others: Error if the list was undefined. 

OP1 = name of list with type set to ListObj. The imaginary part of each 

element is deleted and the data storage area is compressed. All symbol 
table pointers are updated. 

Registers All 
destroyed: 

Remarks: Do not use this routine if the input list is already a real list. 
Example: 
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ConvLrToLc 



Category: List 

Description: Converts an existing real list variable to a complex list variable. 
Inputs: 

Registers: DE = pointer to data storage for list, output of ChkFindSym 
Flags: None 

Others: FPST = name of variable converted, see Floating Point Stack 
Outputs: 

Registers: DE = pointer to data storage of converted list 
Flags: None 

Others: Error if not enough free RAM to convert to complex. 

Each element of the list is converted to a complex number with a 0 imaginary 
part. 

FPST = name of variable converted, see Floating Point Stack. 
All symbol table pointers are updated. 

All 



Registers 
destroyed: 

Remarks: 

Example: 



Do not use this routine if the input list is already a complex list. 
Convert real list L1 to a complex list. 



LD 
RST 

B CALL 



HL, LIName 

rMov9ToOPl 

PushRealOl 



OP1 = LI name 

FPST = name of list 



B_CALL FindSym 

JP C, convertError 



look it up, DE = pointer 

to data storage 

jump out if LI is not 

defined 



AppOnErr convertError 



_CALL 



AppOf f Err 



ConvLrToLc 



install error handler in 
case not enough RAM 

attempt to convert to 
complex 

remove error handler, 
successful 



convertError : 



_CALL 



PopRealOl 



remove name of list from 
FPST 



RET 



LIName : 



ListObj, tVarLst, tLl, 0, 0 
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DelListEl 



Category: 

Description: 

Input: 

Registers: 



Flags: 
Others: 
Output: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 
Example: 



List 

Deletes one or more elements from an existing list, residing in RAM. 



A = ListObj if the list has real elements 

= CListObj if the list has complex elements 
DE = pointer to start of list's data storage, output of FindSym 
HL = number of elements to delete 
BC = element number to start deleting at 

None 

None 



HL = pointer to start of list's data storage, output of FindSym 
DE = new dimension of the list. 



None 

(insDelPtr) 

All 



pointer to start of the list 



DO NOT ATTEMPT ON AN ARCHIVED LIST. The size bytes of the list are 
adjusted. All pointers in the symbol table are updated 

Delete three elements from list L1 starting with element number two. 



LD 
RST 

B_CALL 
JP 



HL, LIName 

rMov9ToOPl 

FindSym 

C, Undef inedLl 



OP1 = LI name 

look it up, DE = pointer 

to data storage 

jump out if LI is not 

defined 



LD 
LD 
OR 
JP 



C, A 
A, B 

A 

NZ, errArchived 



save type 

get archived status 
in RAM or archived 
cannot insert if archived 



LD 
AND 
LD 
LD 



A, C 
lFh 
HL, 3 
BC, 2 



get type back 
mask type of list in ACC 
want to delete 3 elements 
delete 2nd element on 



B_CALL 



DelListEl 



delete elements 



LIName : 



D 3 



ListObj, tVarLst, tLl, 0, 0 
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Find Parse Formula 



Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



List 

Checks if a list variable has a formula attached to it and parses the formula 
and stores it back into the list data. 



None 
None 

OP1 = name of list 

None 
None 

If no error, then the list values are updated. 
All 

If no formula is attached, nothing is done to the existing list data. 

Any error that occurs during the parsing of the formula will cause an error 
screen to be displayed if no error handler is invoked. 

If the resulting type from the formula parsing is not a list, this will also generate 
an error. 

See Error Handlers. 



Example: 
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GetLToOPI 

Category: List 

Description: Copies a list element to OP1 or OP1/OP2. 
Inputs: 

Registers: HL = element number to copy 

DE = pointer to start of list's data storage 

Flags: None 

Others: None 

Outputs: 

Registers: HL = pointer to next element in the list 

Flags: None 

Others: OP1 = list element if a real list 

OP1/OP2 = list element if a complex list 

Registers All 
destroyed: 

Remarks: 

Example: 
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IncLstSize 

Category: List 

Description: Increments the size of an existing list in RAM by adding one element at the 
end of the list. No value is stored in the new element. 

Input: 

Registers: A = ListObj if the list has real elements 

= CListObj if the list has complex elements 
DE = pointer to start of list's data storage, output of FindSym 

Flags: None 

Others: None 

Output: 

Registers: DE = intact 

HL = new dimension of the list 

Flags: None 

Others: (insDelPtr) = pointer to start of the list 

Registers All 
destroyed: 

Remarks: DO NOT ATTEMPT ON AN ARCHIVED LIST. A memory error will be 
generated if insufficient RAM. The size bytes of the list are adjusted. All 
pointers in the symbol table are updated. 

(continued) 
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IncLstSize (continued) 

Example: Increment real list L1 and store a 3 in the new element. 



LD 
RST 

B_CALL 
JP 



HL, LIName 

rMov9ToOPl 

FindSym 

C, Undef inedLl 



0P1 = LI name 

look it up, DE = pointer to 

data storage 

jump out if LI is not 

defined 



LD 
OR 
JP 



A, B 

A 

NZ, errArchived 



; get archived status 

; in RAM or archived 

; cannot insert if archived 



LD 



_CALL 



A,ListObj ; type of list in ACC 

IncLstSize ; insert element at end 



PUSH 
PUSH 



_CALL 



DE 
HL 



0PlSet3 



save pointer to list 
save last element #, just 
inserted 

0P1 = 3 



POP 
POP 



HL 
DE 



; restore 



_CALL 



PutToL 



; store 0P1 to inserted 
; element 



LIName : 



D 3 



ListObj, tVarLst, tLl, 0, 0 
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InsertList 



Category: 

Description: 

Inputs: 

Registers: 



Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



List 

Inserts one or more elements into an existing list, residing in RAM. 



A = ListObj if the list has real elements 

A = CListObj if the list has complex elements 

DE = pointer to start of list's data storage, output of FindSym 

HL = number of elements to insert 

BC = List element number to insert after 

CA = 0 to set new elements to 0 
CA = 1 to set new elements to 1 

None 



DE = intact 

HL = new dimension of the list. 
None 

(insDelPtr) = pointer to start of the list 
All 

DO NOT ATTEMPT ON AN ARCHIVED LIST. A memory error will be 
generated if insufficient RAM. The size bytes of the list are adjusted. All 
pointers in the symbol table are updated 



(continued) 
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InsertList (continued) 



Example: 



Insert three new elements in list L1 after its second element, set the new 
elements to O's. 



LD 
RST 

B_CALL 
JP 



HL, LIName 

rMov9ToOPl 

FindSym 

C, Undef inedLl 



OP1 = LI name 

look it up, DE = pointer to 

data storage 

jump out if LI is not 

defined 



LD 
LD 
OR 
JP 



C, A 
A, B 

A 

NZ, errArchived 



save type 

get archived status 
in RAM or archived 
cannot insert if archived 



LD 

AND 

LD 

LD 

OR 



A, C 
lFh 
HL, 3 
BC, 2 

A 



get type back 
mask type of list in ACC 
want to insert 3 elements 
insert after 2nd element 
CA = 0, to set new elements 
to 0 



B CALL 



InsertList 



insert elements 



LIName : 



E'3 



ListObj, tVarLst, tLl, 0, 0 
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PutToL 

Category: 
Description: 

Inputs: 

Registers: 

Flags: 
Others: 



Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



List 

Stores either a floating-point number or a complex pair to an existing element 
of a list. 

HL = element number to store to 

There is no check to see if this element is valid for the list. 

DE = pointer to the start of the list's data area, output of FindSym 

None 

None 

OP1 = floating-point number set to RealObj to store to a real list 

OP1/OP2 = floating-point numbers representing a complex number to store to 
a complex list 

There are no checks made that the correct data type is being stored to the 
correct type of list (real/complex). 

DE = pointer to next element in the list 
None 

OP1/OP2 = intact 
All 



; Look up LI and store 1 to element 30. 

LD HL, Llname 

B_CALL Mov9ToOPl ; OP1 = name 

B_CALL FindSym ; look up 

RET C ; return if undefined 



Llname : 



DE = pointer to data area of list 



PUSH DE ; save pointer 

B_CALL OPISetl ; OP1 = 1 

POP DE 

LD HL, 30d ; element to store to 

B_CALL PutToL ; store 1 to element 30 
RET 



DB ListObj,tVarLst,tLl, 0 
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10 



System Routines 
Math 



Abs0102Cp |ToT 

Abs01PAbs02 J10-2 

ACos |1 0-3 

ACosH |l04 

ACosRad |1 0-5 

Angle |1 0-6 

ASin |10-7 

ASinH |10-8 

ASinRad |1 0-9 

ATan 110-10 

ATan2 [UKjT 

ATan2Rad [10-12 

ATanH |lCH3 

ATanRad |1 0-1 4 

CAbs ITCM5 

CAdd fKH6 

CDiv H 0-1 7 

CDivByReal |1 0-1 8 

CEtoX ITCM9 

CFrac |1 0-20 

Clntgr |10-21 

Cklnt |Tf>22 

CkOdd 110-23 

CkOPICO 110-24 

CkOPICplx 110-25 

CkOPIFPO 110-26 

CkOPIPos 110-27 
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CkOPIReal 10-28 



CkOP2FP0 10-29 



CkOP2Pos 10-30 



CkOP2Real 10-31 



CkPosInt 10-32 



CkValidNum 10-33 



CLN 10-34 



CLog 10-35 



ClrLp 10-36 



ClrOPIS 10-37 



CMItByReal 10-38 



CMult 10-39 



Conj 110-40 



COPISetO 10-41 



Cos 10-42 



CosH 10-43 



CpOP10P2 110-44 



CpOP40P3 10-45 



CRecip 110-46 



CSqRoot 10-47 



CSquare 10-48 



CSub 10-49 



CTenX 10-50 



CTrunc 10-51 



Cube 10-52 



CXrootY 10-53 



CYtoX 10-54 



Deed Exp 10-55 



DToR 10-56 



EToX 10-57 



ExpToHex |1 0-58 

Factorial |1 0-59 

FPAdd [KH30 

(continued) 
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FPDiv 10-61 



FPMult 10-62 



FPRecip 110-63 



FPSquare 10-64 



FPSub 10-65 



Frac 1 0-66 



HLTimes9 10-67 



HTimesL 10-68 



Int 10-69 



Intgr 10-70 



InvOPIS 10-71 



InvOPISC 10-72 



lnvOP2S 10-73 



InvSub 10-74 



LnX 10-75 



LogX 110-76 



Max 10-77 



Min 10-78 



Minusl 10-79 



OPIExpToDec |1 0-80 



OPISetO, OP1Set1, OP1Set2, OP1Set3, OP1Set4, OP2SetO, OP2Set1, 
OP2Set2, OP2Set3, OP2Set4, OP2Set5, OP2Set60, OP3SetO, OP3Set1 , 
OP3Set2, OP4Set0, OP4Set1 , OP5SetO H 0-81 



OP2Set8 10-82 



OP2SetA 10-83 



Plusl 10-84 



PToR 10-85 



Randlnit 10-86 



Random 10-87 



RName 10-88 



RndGuard 10-89 



RnFx 10-90 



Round 10-91 



RToD 10-92 



RToP 10-93 
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Sin 10-94 



SinCosRad 10-95 



SinH 10-96 



SinHCosH 10-97 



SqRoot ITCHES 



Tan 1 0-99 



TanH 10-100 



TenX 10-101 



ThetaName 10-102 



Times2 10-103 



TimesPt5 10-104 



TName 10-105 



ToFrac 10-106 



Trunc 10-107 



XName 10-108 



XRootY 10-109 



YName 10-110 



YToX 10-111 



Zero16D 10-112 



ZeroOP 10-113 



ZeroOPI, ZeroOP2, ZeroOP3 10-114 
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Abs0102Cp 



Category: 



Math 



Description: Compares Abs(OP1 ) to Abs(OP2). 
Inputs: 

Registers: None 



Outputs: 

Registers: None 

Flags: Z = 1 : Abs(OP1) = Abs(OP2) 

Z = 0, CA = 1 : Abs(OP1 ) < Abs(OP2) 
Z = 0, CA = 0: Abs(OP1 ) >= Abs(OP2) 

Others: OP1 = Abs(OP1) 



Flags: 



None 



Others: 



OP1 = floating point 
OP2 = floating point 



Registers 
destroyed: 



OP2 = Abs(OP2) 
A, BC, DE, HL 



Remarks: 



None 



Example: 
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AbsOl PAbs02 

Category: Math 

Description: Calculates the sum of the absolute values of the floating point in OP1 plus the 
floating point in OP2. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
OP2 = floating point 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = floating point with value (Abs(OP1 ) + Abs(OP2)) 

Registers A, BC, DE, HL 
destroyed: 

Remarks: None 
Example: 
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ACos 

Category: Math 

Description: Computes the inverse cosine of a floating point. The answer will not go 
complex. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = inverse cosine (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: Domain error if answer is complex. 
Example: 
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ACosH 

Category: Math 

Description: Computes inverse hyperbolic cosine of a floating point. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = inverse hyperbolic cosine (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: Domain error if OP1 is negative. 
Example: 



TI-83 Plus Developer Guide 



10-4 



Third Release January 25, 2002 



System Routines — Math 



ACosRad 

Category: Math 

Description: Computes the inverse cosine of a floating point and force radian mode. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = inverse cosine (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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Angle 



Category: Math 

Description: Calculates a polar complex angle from a rectangular complex. 
Input: 

Registers: None 

Flags: None 

Others: OP1 = real representing complex X 
OP2 = real representing complex Y 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = real representing complex angle 

Registers All 
destroyed: 

Remarks: OP1 is not modified. 
Example: 
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ASin 

Category: Math 

Description: Computes the inverse sine of a floating point. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = inverse sine (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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ASinH 

Category: Math 

Description: Computes the inverse hyperbolic sine of a floating point. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = inverse sine (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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ASinRad 

Category: Math 

Description: Computes the inverse sine of a floating point and force radian mode. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = inverse sine (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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ATan 

Category: Math 

Description: Computes the inverse tangent of a floating point. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = inverse tangent (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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ATan2 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Math 

Returns the angle portion of a complex number in rectangular form. 



None 

trigDeg, (IY + trigFlags) = 1 to return angle in degrees 

= 0 to return angle in radians 

OP1 = imaginary part of complex number, floating-point number 
OP2 = real part of complex number, floating-point number 



None 
None 

OP1 = the angle portion of the polar form of the input rectangular complex 
number. 

All 



OP1 -OP5 
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ATan2Rad 

Category: Math 

Description: Returns the angle portion of a complex number in rectangular form — forced 
to return the angle in radians no matter what the current system angle settings 
are. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1 = imaginary part of complex number, floating-point number 
OP2 = real part of complex number, floating-point number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = the angle portion of the polar form of the input rectangular complex 
number. 

Registers All 
destroyed: 



RAM used: OP1 -OP5 

Remarks: 

Example: 
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ATanH 



Category: Math 

Description: Computes the inverse hyperbolic tangent of a floating point. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = inverse hyperbolic tangent (floating point) 
All 



Registers 
destroyed: 

RAM used: 
Remarks: 



OP1, OP2, OP3, OP4, OP5 
Initial input rules: 

If floating point = 0, then output = 0. 

If the absolute value of input is greater than 1 then domain 
error. 

FOR |OP1 1 <7 Use Cordic; otherwise, use Logs. 



Example: 
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ATanRad 

Category: Math 

Description: Computes the inverse tangent of a floating point and forces radian mode. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = inverse tangent (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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CAbs 

Category: Math 

Description: Computes the magnitude of a complex number. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point result, a real number 

Registers All 
destroyed: 

RAM used: OP1 -OP4 

Remarks: SqRoot(OP1 A 2 + OP2 A 2). 

Example: b_call CAbs 
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CAdd 

Category: Math 

Description: Addition of two complex numbers. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = second argument 
FPS1/FPST = first argument 

Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex result (first argument) + (second Argument) 

Registers All 
destroyed: 

RAM used: OP1 -OP2 

Remarks: First argument is removed from the FPS (Floating Point Stack). 

Example: See CSub. 
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CDiv 

Category: Math 

Description: Division of two complex numbers. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = second argument 
FPS1/FPST = first argument 

Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex result (first argument) / (second Argument) 

Registers All 
destroyed: 

RAM used: OP1 -OP4 

Remarks: First argument is removed from the FPS (Floating Point Stack). 

Example: See CSub. 
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CDivByReal 

Category: Math 

Description: Divides a complex number by a real number. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex number 

OP3 = floating point real number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex result, OP1/OP2 / OP3 
OP3 = intact 

Registers All 
destroyed: 



RAM used: OP1 -OP4 
Remarks: 

Example: B_CALL CDivByReal 
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CEtoX 

Category: Math 

Description: Returns e A X where X is a complex number. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex result 

Registers All 
destroyed: 



RAM used: 

Remarks: 

Example: 



OP1 -OP6 



CALL CEtoX 
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CFrac 

Category: Math 

Description: Returns the fractional part of both the real and imaginary components of a 
complex number. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex result 

Registers All 
destroyed: 

RAM used: OP1.0P2 
Remarks: 

Example: b_call CFrac 
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Clntgr 



Executes the Intgr function on a complex number. 



Category: Math 
Description: 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex result 

Registers All 
destroyed: 



RAM used: 
Remarks: 



Example: 



OP1, OP2 

Return the next integer less than or equal to, for both the real and imaginary 
parts of the complex number. 

See Intgr. 

B_CALL Clntgr 
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Cklnt 

Category: Math 

Description: Tests floating-point number to be an integer. 
Inputs: 

Registers: HL = pointer to the exponent of the number to check 

Flags: None 

Others: None 
Outputs: 

Registers: Z = 1 if integer, Z = 0 if noninteger 

Flags: None 

Others: None 

Registers All 
destroyed: 

RAM used: OP1 -OP5 

Remarks: If exponent of OP1 > 13 then it is considered to be an integer. 
Example: 
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CkOdd 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 
Remarks: 

Example: 



Math 

Tests if a floating-point number is odd or even. 

HL = pointer to exponent of number to check 

None 

None 



None 

If even, then Z = 1 . If odd, then Z = 0. 

None 

All 

None 

If exponent of OP1 > 13, then it is considered to be an even. 

If 0 < Abs(OP1) < 1, then it is considered odd, negative exponent. 

Test a floating-point number in OP1 for add/even. 



LD 



_CALL 



JP 



HL, OP1+1 

CkOdd 

Z, Is_Even 
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CkOPICO 

Category: Math 

Description: Tests a complex number in OP1/OP2 to be (0,0). 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex number 
Outputs: 

Registers: None 

Flags: If (0,0), then Z = 1 ; otherwise, Z = 0. 

Others: None 

Registers A 
destroyed: 

Remarks: 

Example: b_call ckopico 
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CkOPICplx 



Category: Math 

Description: Tests value in OP1 for complex data type. 
Inputs: 

Registers: None 

Flags: None 

Others: (OP1 ) = objects data type byte 
Outputs: 

Registers: None 

Flags: If OP1 contains a complex number, then Z = 1 ; otherwise, Z = 0. 

Others: None 

Registers A 
destroyed: 

RAM used: None 
Remarks: 

Example: b_call ckopicpix 
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CkOPIFPO 

Category: Math 

Description: Tests floating-point number in OP1 to be 0. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number 

Outputs: 

Registers: None 

Flags: Z = 1:OP1=0 
Z = 0:OP1 <>0 

Others: None 

Registers A 
destroyed: 

RAM used: None 
Remarks: 

Example: b_call ckopiFPO 
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CkOP1 Pos 

Category: Math 

Description: Tests floating-point number in OP1 to be positive. 
Inputs: 

Registers: None 

Flags: None 

Others: (OP1) = sign byte of floating-point number in OP1 

Outputs: 

Registers: ACC bit 7 = sign bit 

Flags: If OP1 > 0, Z = 1 ; otherwise, Z = 0. 

Others: None 

Registers A 
destroyed: 



RAM used: 

Remarks: 

Example: 



None 



CALL 



CkOPlPos 



TI-83 Plus Developer Guide 



10-27 



Third Release January 25, 2002 



System Routines — Math 



CkOP1 Real 

Category: Math 

Description: Tests object in OP1 to be a real data type. 
Inputs: 

Registers: None 

Flags: None 

Others: (OP1 ) = objects data type byte 
Outputs: 

Registers: ACC = data type of object in OP1 

Flags: If OP1 contains a real number, then Z = 1 ; otherwise, Z = 0. 

Others: None 

Registers A 
destroyed: 

RAM used: None 
Remarks: 

Example: b_call ckopiReai 
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CkOP2FP0 

Category: Math 

Description: Tests floating-point number in OP2 to be 0. 
Inputs: 

Registers: None 

Flags: None 

Others: OP2 = floating-point number 
Outputs: 

Registers: None 

Flags: If OP2 = 0, then Z = 1 ; otherwise, Z = 0. 

Others: None 

Registers A 
destroyed: 



RAM used: 

Remarks: 

Example: 



None 



CALL 



CkOP2FP0 
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CkOP2Pos 

Category: Math 

Description: Tests floating-point number in OP2 to be positive. 
Inputs: 

Registers: None 

Flags: None 

Others: (OP2) = sign byte of floating-point number in OP2 

Outputs: 

Registers: ACC bit 7 = sign bit 

Flags: If OP2 > 0, then Z = 1 ; otherwise, Z = 0. 

Others: None 

Registers A 
destroyed: 

RAM used: None 
Remarks: 

Example: b_call ckop2Pos 
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CkOP2Real 

Category: Math 

Description: Tests object in OP2 to be a real data type. 
Inputs: 

Registers: None 

Flags: None 

Others: (OP1 ) = objects data type byte 
Outputs: 

Registers: ACC = data type of object in OP2 

Flags: If OP2 contains a real number, then Z = 1 ; otherwise, Z = 0. 

Others: None 

Registers A 
destroyed: 

RAM used: None 
Remarks: 

Example: b_call ckop2Reai 
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CkPosInt 

Category: Math 

Description: Tests floating-point number in OP1 to be a positive integer. 
Inputs: 

Registers: OP1 = floating-point number 

Flags: None 

Others: None 
Outputs: 

Registers: If OP1 is a positive integer, then Z = 1 . 

Flags: None 

Others: None 

Registers All 
destroyed: 

RAM used: None 
Remarks: 

Example: B_CALL CkPosInt ; check OP1 = positive integer 

JR Z,PosInt ; jump if positive integer 
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CkValidNum 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 
Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Math 

Checks for a valid number for a real or complex number in OP1/OP2. 
OP1 , if real 

OP1 and OP2, if complex 

None 

None 



Err: Overflow if exponent > 100 
Value set to 0 if exponent < -99 

None 

None 

AF, HL 

This should be used before storing a real or complex to a user variable or a 
system variable. 

Intermediate results from the math operations can generate values outside of 
the valid exponent range for the TI-83 Plus. This routine will catch those 
cases. 

If this is not done, then problems can occur when trying to display the invalid 
numbers. 

This does not need to be done after every floating-point operation. The core 
math routines can handle exponents in the range or +/- 127. 

After a floating-point multiply, check the result for validity before stringing to 
variable X. Assume OP1 and OP2 have values already. 

B_CALL FPMult ; generate value to store to 'X' 

B_CALL CkValidNum ; make sure valid exponent 

B_CALL StoX ; store to 'X' 
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CLN 

Category: Math 

Description: Computes the natural log of a complex number. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex result 

Registers All 
destroyed: 

RAM used: OP1 -OP6 
Remarks: 

Example: b_call cln 
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CLog 



Category: Math 

Description: Computes the base 10 log of a complex number. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex result 

Registers All 
destroyed: 



RAM used: 

Remarks: 

Example: 



OP1 -OP6 



CALL 



CLoc 
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ClrLp 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 
Example: 



Math 

Clears a memory block (to OOh's). 



HL = address of start of memory block 
B = number of bytes to clear 

None 

None 



None 
None 

Memory block cleared 
B, HL 



None 
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ClrOPIS 

Category: Math 

Description: Clears the mantissa sign bit in OP1 . 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: This routine only acts on the display, not the textShadow. 
Example: 
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CMItByReal 

Category: Math 

Description: Multiplies a complex number by a real number. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex number 

OP3 = floating point real number 

Outputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = complex result, OP1/OP2 OP3 
OP3 = intact 

Registers All 
destroyed: 



RAM used: OP1 -OP4 
Remarks: 

Example: b_call cMitByReai 
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CMult 

Category: Math 

Description: Multiplication of two complex numbers. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = second argument 
FPS1/FPST = first argument 

Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex result (first argument) * (second argument) 

Registers All 
destroyed: 

RAM used: OP1 -OP4 

Remarks: First argument is removed from the FPS (Floating Point Stack). 

Example: See CSub. 
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Conj 



Category: Math 

Description: Computes the complex conjugate of a real complex number. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = real complex number 
Outputs: 

Registers: None 

Flags: None 

Others: OP2 = -OP2, negate imaginary 

Set OP1/OP2 = current complex mode 

Registers All 
destroyed: 

Remarks: No error checking. Sets Ans to the current complex mode. 
Example: 



TI-83 Plus Developer Guide 



10-40 



Third Release January 25, 2002 



System Routines — Math 



COP1 SetO 

Category: Math 

Description: Puts a complex (0,0) in OP1/OP2. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 /OP2 = complex (0,0) 

Registers A, HL 
destroyed: 

Remarks: OP1 is not modified. 
Example: 
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Cos 



Category: Math 

Description: Computes the cosine of a floating point. 
Inputs: 

Registers: None 

Flags: None 

Others: Current angle mode 
OP1 = floating point 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = cosine (floating point) 

Registers All 
destroyed: 



RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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CosH 

Category: Math 

Description: Computes the hyperbolic cosine of a floating point. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = hyperbolic cosine (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 

Remarks: 

Example: 
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CpOP10P2 



Category: Math 

Description: Compares floating-point values in OP1 and OP2. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point value 
OP2 = floating-point value 

Outputs: 

Registers: None 

Flags: Z=1:OP1=OP2 

Z = 0, CA=1:OP1 <OP2 
Z = 0, CA = 0:OP1 >=OP2 

Others: None 

Registers A, BC, DE, HL 
destroyed: 

Remarks: OP1 and OP2 are preserved. 
Example: 
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CpOP40P3 



Category: Math 

Description: Compares floating-point values in OP4 and OP3. 
Inputs: 

Registers: None 

Flags: None 

Others: OP4 = floating-point value 
OP3 = floating-point value 

Outputs: 

Registers: None 

Flags: Z=1:OP4 = OP3 

Z = 0, CA=1:OP4<OP3 
Z = 0, CA = 0: OP4 >= OP3 

Others: None 

Registers A, BC, DE, HL 
destroyed: 

RAM used: OP1.0P2 

Remarks: OP4 and OP3 are preserved. 

Example: 
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CRecip 



Category: Math 

Description: Computes the reciprocal of a complex number. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = input complex number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = resulting complex number 

Registers All 
destroyed: 

RAM used: OP1 -OP4 
Remarks: 

Example: b_call CRecip 
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CSqRoot 



Category: Math 

Description: Computes the square root of a complex number. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex result 

Registers All 
destroyed: 

RAM used: OP1 -OP6 
Remarks: 

Example: b_call csqRoot 
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CSquare 



Category: Math 

Description: Computes the square of a complex number. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex result 

Registers All 
destroyed: 

RAM used: OP1 -OP4 
Remarks: 

Example: B_CALL CSquare 



TI-83 Plus Developer Guide 



10-48 



Third Release January 25, 2002 



System Routines — Math 



CSub 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Math 

Subtracts two complex numbers. 

None 
None 

OP1/OP2 = second argument 
FPS1/FPST = first argument 

None 
None 

OP1/OP2 = complex result (first argument) - (second argument) 
All 

OP1 -OP3 

First argument is removed from the FPS (Floating Point Stack). 

Assume that variable X and Y both have complex values. 

Recall the contents and subtract Y from X, such that OP1/OP2 = X - Y 



CALL 



RolX 



; OP1/OP2 = complex value of X 



This next call pushes OP1 the real part of the complex #, onto FPST; 
then pushes OP2, the imaginary part, onto the FPST which pushes the 
real part to FPS1 position. 

FPS1 = 1st argument real part 
FPST = 1st argument imaginary part 



_CALL 
_CALL 
_CALL 



PushMCplxOl ; push 1st argument on FPS, X 



RclY 
CSub 



; OP1/OP2 = complex value of Y 

; OP1/OP2 = result X N Y, FPS 
; is cleaned 
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CTenX 

Category: Math 

Description: Returns 10 A X where X is a complex number. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex result 

Registers All 
destroyed: 

RAM used: OP1 -OP6 
Remarks: 

Example: b_call denx 
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CTrunc 

Category: Math 

Description: Returns the integer part of both the real and imaginary components of a 
complex number; no rounding is done. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex result 

Registers All 
destroyed: 

RAM used: OP1.0P2 

Remarks: No rounding is done; for example, Trunc (1 .5 + 3i) returns 1 + 3i. 

Example: b_call CTrunc 
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Cube 

Category: Math 

Description: Computes the cube of a floating-point number. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = OP1 A 3 

Registers A, BC, DE, HL 
destroyed: 

RAM used: OP1 -OP3 
Remarks: 

Example: b_call cube 
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CXrootY 

Category: Math 

Description: Returns the complex root of a complex number, y A (1/x). 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = second argument (y) 
FPS1/FPST = first argument (x) 

Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex result second_argument A (1/(first_argument)) 

Registers All 
destroyed: 

RAM used: OP1 -OP6 

Remarks: First argument is removed from the FPS (Floating Point Stack). 

Example: See CSub. 
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CYtoX 

Category: Math 

Description: Raises a complex number to a complex power, y A x. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = second argument (x) 
FPS1/FPST = first argument (y) 

Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = complex result first_argument A (second_argument) 

Registers All 
destroyed: 

RAM used: OP1 -OP6 

Remarks: First argument is removed from the FPS (Floating Point Stack). 

Example: See CSub. 
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DecOl Exp 



Category: Math 

Description: Decrements OP1 exponent. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 
Outputs: 

Registers: None 

Flags: None 

Others: Decrement OP1 exponent by one. 

Registers A 
destroyed: 

Remarks: 

Example: b_call DecoiExp 
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DToR 

Category: Math 

Description: Converts the floating-point number in OP1 from a degrees angle to a radian 
angle. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number to convert 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number representing the radian angle of the input value 

Registers All 
destroyed: 

RAM used: OP1,OP2, OP3 

Remarks: 

Example: 
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EToX 

Category: Math 

Description: Computes e A OP1 = 10 A (OP1*LOG(e)). 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = value e is raised to 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = result 

Registers All, OP2, OP3, OP4 
destroyed: 

Remarks: 
Example: 
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ExpToHex 



Category: Math 

Description: Converts absolute value of one-byte. 

Exponent (in HL) to hexadecimal. 

Inputs: 

Registers: (HL) = exponent to convert 

Flags: None 

Others: None 
Outputs: 

Registers: (HL) = absolute value of exponent 

Flags: None 

Others: None 

Registers A 
destroyed: 



Remarks: 



This converts the floating point exponent value from the offset type 
(e.g., 7Fh = 1 0 A -1 , 80h = 1 0 A 0, 81 h = 1 0 A 1 ,...) to a value of 0...n. It treats 
positive and negative exponents the same: 

e.g., 80h = 0 
81 h = 1 
82h = 2 
7Fh = A1 
7Eh = A2 

See OPIExpToDec for another exponent conversion routine. 



Example: 



LD 
LD 

B_CALL 



HL, Exponent 
(HL) , 7Eh 
ExpToHex 



change (HL) from FEh N> 02h. 
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Factorial 

Category: Math 

Description: Computes the factorial of an integer or a multiple of .5. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number, must be an integer or a multiple of .5 in the 
range of -.5 to 69 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = factorial of input, floating-point number. Else, error if input is out of 
range. 

Registers All 
destroyed: 

RAM used: OP1 -OP3 

Remarks: 

Example: 
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FPAdd 



Category: Math 

Description: Floating point addition of OP1 and OP2. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number, argument one 
OP2 = floating-point number, argument two 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point result OP1 + OP2 

Registers All 
destroyed: 



RAM used: OP1.0P2 
Remarks: 

Example: b_call FPAdd 



TI-83 Plus Developer Guide 



10-60 



Third Release January 25, 2002 



System Routines — Math 



FPDiv 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Math 

Floating point division of OP1 and OP2. 



None 
None 

OP1 = floating-point number, argument one 
OP2 = floating-point number, argument two 



None 
None 

OP1 = floating point result OP1 / OP2 
OP2 = intact 

All 



OP1, OP2, OP3 



B_CALL FPDiv 



TI-83 Plus Developer Guide 



10-61 



Third Release January 25, 2002 



System Routines — Math 



FPMult 



Category: Math 

Description: Floating point multiplication of OP1 and OP2. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number, argument one 
OP2 = floating-point number, argument two 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point result OP1 * OP2 
OP2 = intact 

Registers All 
destroyed: 



RAM used: OP1.0P2, OP3 
Remarks: 

Example: b_call FPMuit 
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FPRecip 



Category: Math 

Description: Floating point reciprocal of OP1 . 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point result 1 / OP1 
OP2 = input OP1 

Registers All 
destroyed: 



RAM used: 

Remarks: 

Example: 



OP1, OP2, OP3 



B CALL 



FPRecip 
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FPSquare 

Category: Math 

Description: Floating point square of OP1 . 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point result OP1 OP1 
OP2 = input OP1 

Registers All 
destroyed: 



RAM used: OP1.0P2, OP3 
Remarks: 

Example: B_CALL FPSquare 
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FPSub 



Category: Math 

Description: Floating point subtraction of OP1 and OP2. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number, argument one 
OP2 = floating-point number, argument two 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point result OP1 N OP2 

Registers All 
destroyed: 



RAM used: OP1.0P2 
Remarks: 

Example: b_call FPSub 
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Frac 

Category: Math 

Description: Returns the fractional part of a floating-point number. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point result 

Registers All 
destroyed: 

RAM used: OP1 

Remarks: No rounding; for example, Frac (1 .5) = .5 

Example: b_call Frac 
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HLTimes9 

Category: Math 

Description: Multiplies HL by nine. 

Inputs: 

Registers: HL = multiplicand 

Flags: None 

Others: None 
Outputs: 

Registers: HL = HL * 9 modulo 65536 

Flags: CA = 1 : answer larger than 65535 
CA = 0: answer less than 65535 

Others: None 

Registers BC 
destroyed: 

Remarks: None 
Example: 
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HTimesL 

Category: Math 

Description: Multiplies H (register) * L (register). 
Inputs: 

Registers: H, L 

Flags: None 

Others: None 
Outputs: 

Registers: HL = product of (original H) * (original L) 

Flags: None 

Others: None 

Registers B, DE 
destroyed: 

Remarks: Restriction: H cannot be 0; If H is 0, performs 256 * L. 
Cannot overflow if H > 0. 

Example: 
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Int 

Category: Math 

Description: Rounds a floating-point number to an integer. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number to round 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = Int (OP1) 

Registers All 
destroyed: 

RAM used: OP1 

Remarks: The mantissa sign of the input has no affect on the result. 

Example: b_call int 
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Intgr 



Math 

Returns the integer. 



Category: 
Description: 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number 
Outputs: 

Registers: None 
Flags: None 

Others: OP1 = floating-point result 
A, BC, DE, HL 



Registers 
destroyed: 

Remarks: 



Example: 



If OP1 is an integer, then result = OP1. Otherwise, 
for positive numbers, returns the same as Trunc (OP1); 
for negative numbers, returns the Trunc (OP1 - 1). 
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InvOPIS 

Category: Math 

Description: Negates a floating-point number OP1 , if OP1 = 0 then set OP1 = positive. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number. No check is made for a valid floating-point 
number. 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = A(OP1 ), unless 0 then it is set to positive. 

Registers A 
destroyed: 

Remarks: 

Example: Set OP1 = A1 

B_CALL OPISetl ; OP1 = floating point 1 

B_CALL InvOPIS ; OP1 = -1 
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InvOPISC 

Category: Math 

Description: Used to negate a complex number in OP1/OP2 by negating both OP1 and 
OP2. If OP1 or OP2 = 0, then that OP register is set positive. 

Inputs: 

Registers: None 
Flags: None 

Others: OP1/OP2 = two floating-point numbers that make up a complex number 
Outputs: 

Registers: None 
Flags: None 

Others: OP1 = -(OP1), unless 0 then it is set to positive 
OP2 = -(OP2), unless 0 then it is set to positive 

Registers A 
destroyed: 

Remarks: 

Example: 
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lnvOP2S 

Category: Math 

Description: Negates a floating-point number OP2, if OP2 = 0 then set OP2 = positive. 
Inputs: 

Registers: None 

Flags: None 

Others: OP2 = floating-point number, no check is made for a valid floating-point 
number. 

Outputs: 

Registers: None 

Flags: None 

Others: OP2 = -(OP2), unless 0 then it is set to positive 

Registers A 
destroyed: 

Remarks: 

Example: Set OP2 = -1 

B_CALL OP2Setl ; OP2 = floating point 1 

B_CALL InvOP2S ; OP 2 = -1 
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InvSub 

Category: Math 

Description: Negates OP1 and add to OP2. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
OP2 = floating point 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point with value (-OP1 ) + OP2 

Registers A, BC, DE, HL 
destroyed: 

RAM used: OP1.0P2 

Remarks: None 
Example: 
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LnX 



Returns natural log of a floating-point number in OP1 . 



Category: Math 
Description: 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number, must be positive 
Outputs: 

Registers: None 

Flags: None 

Others: Error if OP1 is negative 
ElseOPI = Ln(OP1) 

All 



Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



OP1 -OP5 

A system error can be generated. See section on Error Handlers. 

Compute the Ln(OP1), install an error handler to avoid the system reporting 
the error. 



AppOnErr CatchError 
B_CALL LnX 
AppOf fErr 

RET 

come here if LnX generated an error 
CatchError : 



; install error handler 

; compute Ln(OPl) 

; remove error handler, no 

; error occurred 
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Logx 



Category: Math 

Description: Returns log base 1 0 of a floating-point number in OP1 . 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number, must be positive 
Outputs: 

Registers: None 



Flags: 
Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



None 

Error if OP1 is negative 
ElseOPI = Log(OP1) 

All 



OP1 -OP5 

A system error can be generated. See section on Error Handlers. 
See LnX. 
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Max 

Category: Math 

Description: Returns the maximum (OP1 , OP2), two floating-point numbers. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number 
OP2 = floating-point number 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = maximum (OP1 , OP2) 
OP2 = intact 

Registers All 
destroyed: 

RAM used: OP1 -OP4 

Remarks: See CpOP10P2, for non destructive compare. 
Example: 
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Min 

Category: Math 

Description: Computes the minimum of two floating-point numbers. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number argument one 
OP2 = floating-point number argument two 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = minimum (OP1 , OP2) 
OP2 = intact 
OP3 = argument one 
OP4 = argument two 

Registers A, BC, DE, HL 
destroyed: 

RAM used: OP1 -OP4 

Remarks: 

Example: 
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Minusl 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Math 

Floating point subtraction of one from OP1 . 

None 
None 

OP1 = floating-point number 

None 
None 

OP1 = floating-point result OP1 - 1 
All 



OP1, OP2 



B_CALL Minusl 
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OP1 ExpToDec 



Category: Math 

Description: Converts absolute value of exponent to a bed number. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 + 1 = exponent to convert 
Outputs: 

Registers: (HL) = OP1 + 1 = |Exp| as hex 
A = |Exp| as bed 



Flags: 

Others: 

Registers 
destroyed: 

Remarks: 
Example: 



None 

OP1 + 1 = |Exp| as hex 
A, BC 

Overflow Error if |Exp| > 99 

; Input OP1 + 1 value -> Output OP1 + 1 and A register 
81h (10 A 1 ) -> Olh & Olh 

7Fh (10 A -1 ) -> Olh & Olh 

8Dh (10 A 13 ) -> ODh & 13h 

73h (10 A -13) -> ODh & 13h 
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OPISetO, OP1Set1, OP1Set2, OP1Set3, OP1Set4 5 
OP2SetO, OP2Set1 , OP2Set2, OP2Set3, OP2Set4, 
OP2Set5, OP2Set60, OP3SetO, OP3Set1 , OP3Set2, 
OP4SetO, OP4Set1 , OP5SetO 



Category: 

Description: 

Inputs: 

Registers: None 
Flags: None 
Others: None 

Outputs: 

Registers: None 
Flags: None 
Others: 



Math Utility 

Sets value of OP(x) to floating point (value). 



Registers 
destroyed: 

Remarks: 



OP(x) = floating-point value 
A, HL 



Example: 



Combinations Available: 








Value 


0 


1 


2 


3 


4 


Register 












OP1 


X 


X 


X 


X 


X 


OP2 


X 


X 


X 


X 


X 


OP3 


X 


X 


X 






OP4 


X 


X 








OP5 


X 










B_CALL 


OP2Set5 











X 



60 



X 
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OP2Set8 

Category: Math 

Description: Sets OP2 = floating point 8. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP2 = floating point 8 

Registers A, HL 
destroyed: 

Remarks: 

Example: 
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OP2SetA 

Category: Math 

Description: Sets OP2 = floating-point value between 0 and 9.9. 
Inputs: 

Registers: ACC = two digits of mantissa to set OP2 to 

Flags: None 

Others: OP2 set to floating-point value 

Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers A, HL 
destroyed: 

Remarks: 

Example: ; set op2 = 7.6 

LD A,76h ; mantissa digits 

B_CALL OP2SetA ; OP2 =7.6 
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Plusl 

Category: Math 

Description: Floating point addition of one to OP1 . 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point result OP1 + 1 

Registers All 
destroyed: 

RAM used: OP1.0P2 
Remarks: 

Example: b_call piusi 
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PToR 

Category: Math 

Description: Converts complex number in OP1/OP2 from a polar complex number to a 
rectangular complex number. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number radius part of complex number 
OP2 = floating-point number angle part of complex number 

Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = rectangular representation of input polar complex number 

Registers All 
destroyed: 

RAM used: OP1 -OP6 

Remarks: 

Example: 
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Randlnit 

Category: Math 

Description: Initializes random number seeds to default value. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers HL, DE, BC 
destroyed: 

Remarks: Seeds initialized. 
Example: 
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Random 

Category: Math 

Description: Returns a random floating-point number, 0 < number < 1 . 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point random number 

Registers All 
destroyed: 

RAM used: OP1 -OP3 

Remarks: See RnFx and Round routines. 

Example: 
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RName 

Category: Math 

Description: Constructs a name for real variable R in the format required by routine 
FindSym. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = contains variable name for R in format required by routine FindSym 

Registers A, HL 
destroyed: 

Remarks: This routine is used to prepare for a call to routine FindSym. 
Example: 
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RndGuard 

Category: Math 

Description: Rounds a floating-point number to 1 0 mantissa digits. The exponent value has 
no effect on this routine. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number to round to 1 0 mantissa digits 

(fmtDigits) = current fix value 
Offh = floating, no rounding will be done 
Otherwise, the value is the number of decimal 
Digits to round to, 0 - 9 

Outputs: 

Registers: None 
Flags: None 

Others: OP1 = input floating point rounded to 10 mantissas digits 

Registers All 
destroyed: 

RAM used: OP1 

Remarks: See the RnFx and Round routines. 
Example: 
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RnFx 

Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Math 

Rounds a floating-point number to the current FIX setting for the calculator. 
This will round the digits following the decimal point. 



None 
None 

OP1 = floating-point number to round 



None 
None 

OP1 = input rounded to at maximum of 10 mantissa digits 

(fmtDigits) = current fix value 
Offh = floating, no rounding will be done 
Otherwise, the value is the number of decimal 
Digits to round to, 0 - 9 

All 



OP1 

See Round and RndGuard routines. 
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Round 

Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 



Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Math 

Rounds a floating-point number to a specified number of decimal places. This 
will round the digits following the decimal point. 



D = number of decimal places to round to, 0 - 9 
None 

OP1 = floating-point number to round 

(fmtDigits) = current fix value 

Offh = floating, no rounding will be done 

Otherwise, the value is the number of decimal digits to round to, 0 - 9 



None 
None 

OP1 = input rounded to at maximum of 10 mantissa digits 
All 



OP1 

See RnFx and RndGuard routines. 
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RToD 

Category: Math 

Description: Converts the floating-point number in OP1 from a radian angle to a degree 
angle. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number to convert 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number representing the degree angle of the input value. 

Registers All 
destroyed: 

RAM used: OP1,OP2, OP3 

Remarks: See DToR routine. 
Example: 
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RToP 

Category: Math 

Description: Converts complex number in OP1/OP2 from a rectangular complex number to 
a polar complex number. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number X part of complex number 
OP2 = floating-point number Y part of complex number 

Outputs: 

Registers: None 

Flags: None 

Others: OP1/OP2 = polar representation of input rectangular complex number 

Registers All 
destroyed: 

RAM used: OP1 -OP6 
Remarks: See RToP routine. 
Example: 
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Sin 

Category: Math 

Description: Computes the sine and cosine of a floating point. 
Inputs: 

Registers: Current angle mode 
OP1 = floating point 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = sine (floating point) 
OP2 = cosine (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 
Remarks: 

Example: b_call sin 
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SinCosRad 

Category: Math 

Description: Computes the sine and cosine of a floating point and radian mode is forced. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = sine (floating point) 
OP2 = cosine (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 
Remarks: 

Example: B_CALL SinCosRad 
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SinH 

Category: Math 

Description: Computes hyperbolic sine of a floating point. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = hyperbolic sine (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 
Remarks: 

Example: b_call sinH 
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SinHCosH 

Category: Math 

Description: Computes the hyperbolic sine and cosine of a floating point. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = hyperbolic sine (floating point) 
OP2 = hyperbolic cosine (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 
Remarks: 

Example: b_call SinHCosH 
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SqRoot 



Category: Math 

Description: Returns the square root of OP1 . 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number, must be positive 
Outputs: 

Registers: None 

Flags: None 

Others: Error if OP1 is negative, else OP1 = Sqrt(OP1 ) 

Registers All 
destroyed: 

RAM used: OP1 -OP3 

Remarks: See section on Error Handlers. 

Example: 
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Tan 

Category: Math 

Description: Computes the tangent of a floating point. 
Inputs: 

Registers: None 

Flags: None 

Others: Current angle mode 
OP1 = floating point 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = tangent (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 
Remarks: 

Example: b_call Tan 



TI-83 Plus Developer Guide 1 0 - 99 Third Release January 25, 2002 



System Routines — Math 



TanH 

Category: Math 

Description: Computes the hyperbolic tangent of a floating point. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = hyperbolic tangent (floating point) 

Registers All 
destroyed: 

RAM used: OP1 , OP2, OP3, OP4, OP5 
Remarks: 

Example: b_call TanH 
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TenX 

Category: Math 
Description: Returns 10 A (OP1). 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = 10 A (OP1) 

Registers All 
destroyed: 

RAM used: OP1 -OP4 

Remarks: 

Example: 
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ThetaName 

Category: Math 

Description: Constructs a name for real variable Theta in the format required by routine 
FindSym. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = contains variable name for Theta in format required by routine 
FindSym 

Registers A, HL 
destroyed: 

Remarks: This routine is used to prepare for a call to routine FindSym. 
Example: 
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Times2 

Category: Math 

Description: Calculates OP1 times two. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point with value OP1 * 2.0 
OP2 = floating point 2 

Registers A, BC, DE, HL 
destroyed: 

RAM used: OP1.0P2 

Remarks: None 
Example: 
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TimesPt5 

Category: Math 

Description: Calculates OP1 times 0.5. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating point with value OP1 * 0.5 
OP2 = floating point 0.5 

Registers A, BC, DE, HL 
destroyed: 

RAM used: OP1.0P2 

Remarks: 

Example: 
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TName 

Category: Math 

Description: Constructs a name for real variable T in the format required by routine 
FindSym. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = contains variable name for T in format required by routine FindSym 

Registers A, HL 
destroyed: 

Remarks: This routine is used to prepare for a call to routine FindSym. 
Example: 
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ToFrac 



Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

Remarks: 



Example: 



Math 

Converts a floating-point number to the integer numerator and integer 
denominator of the equivalent fraction. 



None 
None 

OP1 = floating-point number 
None 

Carry = 0: Success 
= 1 : Failure. 

OP1: 

On Failure — unchanged. 

On Success — Numerator (floating-point integer) 

OP2: 

On Failure — unchanged. 

On Success — Denominator (floating-point integer) 
All 

Also modifies OP3, OP4, OP5, OP6. 
Smallest possible denominator is created. 
Fails if denominator must be > 999. 

LD HL, ExampleNum 

RST rMov9ToOPl 

; OP1 =1.25 

B_CALL ToFrac 
; Convert to fraction form 

; Carry is now 0 (success) 

; OP1 now contains: OOh 80h 50h OOh OOh OOh OOh OOh OOh = 5 

; OP2 now contains: OOh 80h 40h OOh OOh OOh OOh OOh OOh = 4 

LD HL, ExampleNum2 

RST rMov9ToOPl 
; OP1 = 1.2345678901234 

B_CALL ToFrac 
; Convert to fraction form 
; Carry is now 1 (failure) 
; ExampleNum = 1.2 5 

ExampleNum: DB OOh, 80h, 12h, 50h, OOh, OOh, OOh, OOh, OOh 
; ExampleNum2 = 1.2345 67 8 901234 

ExampleNum: DB OOh, 80h, 12h, 34h, 56h, 78h, 90h, 12h, 34h 
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Trunc 

Category: Math 

Description: Truncates the fractional portion of a floating-point number returning the integer 
portion with no rounding. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = Trunc (OP1) 

Registers All 
destroyed: 

RAM used: OP1 -OP2 
Remarks: 

Example: Trunc (1. 5) = 1 
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XName 

Category: Math 

Description: Constructs a name for real variable X in the format required by routine 
FindSym. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = contains variable name for X in format required by routine FindSym 

Registers A, HL 
destroyed: 

Remarks: This routine is used to prepare for a call to routine FindSym. 
Example: 
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XRootY 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Math 

Inverses power function and returns OP1 A (1/OP2). 



None 
None 

OP1 = number to find root of, floating point 
OP2 = root to find, floating point 



None 
None 

OP1 = result if no error, floating point 
All 



OP1 -OP6 
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YName 

Category: Math 

Description: Constructs a name for real variable Y in the format required by routine 
FindSym. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = contains variable name for Y in format required by routine FindSym 

Registers A, HL 
destroyed: 

Remarks: This routine is used to prepare for a call to routine FindSym. 
Example: 



TI-83 Plus Developer Guide 



10-110 



Third Release January 25, 2002 



System Routines — Math 



YToX 

Category: Math 

Description: Power function, returns OP1 A OP2. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = number to raise to a power, floating point 
OP2 = power, floating point 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = result if no error, floating point 

Registers All 
destroyed: 

RAM used: OP1 -OP6 

Remarks: 

Example: 
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Zero16D 

Category: Math 

Description: Sets eight-byte memory block to all OOh's. 
Inputs: 

Registers: HL = start of target block in memory 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: Memory block starting at original HL is all OOh's 

Registers A, HL 
destroyed: 

Remarks: 
Example: 
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ZeroOP 

Category: Math 

Description: Sets 1 1 bytes in OP(x) to OOh. 

Note that this does not set the value to floating point 0.0. 

Inputs: 

Registers: HL = pointer to OP(x), x = 1 ...6 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP(x) = all 1 1 bytes OOh 

Registers A (= 0), HL 
destroyed: 

Remarks: 

Example: ; Set OP2 contents to all OOh: 

; OP2+0 OP2+1 OP2+3 OP2+4 OP2+5 OP2+6 OP2+7 OP2+8 OP2+9 OP2+10 
; OOh OOh OOh OOh OOh OOh OOh OOh OOh OOh 

LD HL,OP2 

B_CALL ZeroOP 
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ZeroOPI, ZeroOP2, ZeroOP3 

Category: Math 

Description: Sets 1 1 bytes in OP(x) to OOh. 

Note that this does not set the value to floating point 0.0. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP(x) = all 1 1 bytes OOh 

Registers A(= 0), HL 
destroyed: 

Remarks: Combinations Available: 
(x) = 1,2,3 

Example: ; Set OP2 contents to all OOh: 

; OP2+0 OP2+1 OP2+3 OP2+4 OP2+5 OP2+6 OP2+7 OP2+8 OP2+9 OP2+10 
; OOh OOh OOh OOh OOh OOh OOh OOh OOh OOh 
B_CALL ZeroOP2 
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System Routines 
Matrix 



AdrMEle |11-1 



AdrMRow \V^2\ 



GetMToOPI 11-3 



PutToMat 11-4 
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AdrMEle 



Computes the RAM address of an element of a matrix. 



Category: List 
Description: 
Inputs: 

Registers: DE = pointer to start of matrix's data storage, output of FindSym 

BC = element's (row, column) to compute address of Matrix Element (1,1) is 
checked for real or complex data type to determine if the matrix is real or 
complex. 

Flags: None 
Others: None 
Outputs: 

Registers: HL = pointer in RAM to start of desired element 

Flags: None 

Other: None 

Registers All 
destroyed: 



Remarks: This routine does not check to see if the element's address requested is within 
the current dimension of the matrix. 

Do not use this routine on a matrix that does not have element (1,1) initialized. 
Example: Compute the address of element (5,6) of matrix [A]. 



MatAName : 



LD 
RST 

B_CALL 
JP 

LD 

OR 
JP 



LD 

B_CALL 

RET 

DB 



HL, MatAName 

rMov9ToOPl 

FindSym 

C, Undef ined_A 

A, B 

A 

NZ, Arohived_A 

BC, 5*256+6 
AdrMEle 



OP1 = [A] name 
look it up 

jump out if [A] is not 
defined; 

if b<>0 then [A] is 
archived in Flash ROM 

jump if not in RAM; 

DE = pointer to start of 

matrix data storage; 

element's address 

desired 

RET HL = pointer to 
element (5,6) 



MatOb j , tVarMat , tMatA, 0 , 0 
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AdrMRow 

Category: Matrix 

Description: Computes the RAM address of the start of a row of a matrix. 
Input: 

Registers: DE = pointer to start of matrix's data storage, output of FindSym 
B = row to compute address of 

Matrix Element (1,1) is checked for real or complex data type to determine if 
the matrix is real or complex. 

Do not use this routine on a matrix that does not have element (1,1) initialized. 
Flags: None 
Others: None 
Output: 

Registers: HL = pointer in RAM to start of desired element 

Flags: None 

Others: None 

Registers All 
destroyed: 

Remarks: This routine does not check to see if the row address requested is within the 
current dimension of the matrix. See AdrMEle routine. 

Example: 
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GetMToOPI 

Category: Matrix 

Description: Copies an element from a matrix to OP1 . 
Input: 

Registers: BC = element to get, row,col 

DE = pointer to start of matrix's data storage 

Flags: None 

Others: None 

Output: 

Registers: HL = pointer to next element in the same row, or the start of the next row of 
the matrix. 

Flags: None 

Other: OP1 = matrix element, floating-point number 

Registers All 
destroyed: 

Remarks: 

Example: 
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PutToMat 



Category: Matrix 

Description: Stores a floating-point number to an existing element of a matrix. 
Inputs: 

Registers: BC = (row, column) to store to 

There is no check to see if this element is valid for the matrix. 



Flags: 
Others: 

Outputs: 



DE = pointer to the start of the matrix's data area, output of FindSym 

None 

None 

OP1 = floating-point number 



Registers: DE = pointer to next element in the matrix. This will be the next element in the 
same row or the start of the next row. 



Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



None 

OP1 = intact 
All 



Look up MatA and store 1 to element (5,7). 



LD 



CALL 



HL, MatAname 
Mov9ToOPl 



; OP1 



B_CALL FindSym ; look up 

RET C ; return if undefined 

; DE = pointer to data area of 

; matrix 



PUSH 
B CALL 



DE 

OPISetl 



; save pointer 
; OP1 = 1 



MatAname : 



POP 
LD 

B_CALL 
RET 

DB 



DE 

BC, 5*257+7 
PutToMat 



; element to store to (5,7) 
; store 1 to element (5,7) 



MatObj,tVarMat,tMatA, 0 
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System Routines 
Memory 



ArcJJnarc |12-1 1 

ChkFindSym |1 2-2 1 

ChkFindSym (continued) |l2-3 

CleanAII Ff2~4 

CloseProg 112-5 

CmpSyms |1 2-6 

CreateOEqu |1 2-7 

CreateAppVar |1 2-8 

CreateCList |12-9 

CreateCplx ITlHrJ 

CreateEqu |12-11 

CreatePair |12-12 

CreatePict |12-13 

CreateProg 112-14 

CreateProtProg |12-15 

CreateReal |12-16 

CreateRList H2-17 

CreateRMat |12-18 

CreateStrng |12-19 

DataSize |1 2-20 

DataSizeA |12-21 

DeallocFPS [12^22 

DeallocFPSI h 2-23 

DelMem |1 2-24 

DelMem (continued) |1 2-25 

DelVar |1 2-26 

DelVarArc 112-27 
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DelVarNoArc 12-28 



EditProg |1 2-29 



EnoughMem 12-30 



Exch9 12-31 



ExLp |12-32 



FindAlphaDn 12-33 



FindAlphaDn (continued) p 2-34 



FindAlphaUp 12-35 



FindAlphaUp (continued) p 2-36 



FindApp 12-37 



FindAppNumPages 12-38 



FindAppDn 12-39 



FindAppUp |1 2-40 



FindSym 12-41 



FindSym (continued) 1 2-42 



FixTempCnt |1 2-43 



FlashToRam W 1 ^ 



InsertMem 12-45 



InsertMem (continued) [12-46 



LdHLInd 12-47 



LoadClndPaged 12-48 



LoadDEIndPaged 12-49 



MemChk 12-50 



PagedGet p 2-51 



RclGDB2 12-52 



RcIN 12-53 



RclVarSym 12-54 



RclX 12-55 



RclY 12-56 



RedimMat 12-57 



SetupPagedPtr 1 2-58 



SrchVLstDn, SrchVLstUp 12-59 
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StMatEl 12-60 



StoAns 12-61 



StoGDB2 12-62 



StoN 12-63 



StoOther 12-64 



StoOther (continued) 12-65 



StoR 12-66 



StoSysTok 12-67 



StoT 12-68 



StoTheta 12-69 



StoX 12-70 



StoY 12-71 
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Arc Unarc 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Swaps a variable between RAM and archive. 

None 
None 

OP1 contains variable name 

None 
None 

Symbol table and data area (RAM and Flash) modified. 
All 

Destroys OP3 as well. 

Will unarchive a variable already archived and will archive a variable that is 
currently unarchived. 

Gives an Err: Variable for any name that is not archivable or unarchivable 
(e.g., Groups cannot be unarchived and X cannot be archived). 
Gives an Err: Undefined for any name that does not already exist. 

Does memory checking to make sure there is enough space (in RAM or in 
Archive) to store the variable. Generates a memory error if not. 

unarchive variable A (real 
or complex) if it is 
archived : 

ZeroOPl ; set OP1 to all Os 

(OPl+l),tA ; want to look for floating 

point number named 'A' 
rFindSym ; Data pointer -> DE 

System pointer -> HL 
C if none 

does not exist, so skip 
NZ if was in RAM already, 
not archived, so no need to 
unarchive 

_CALL Arc_Unarc ; unarchive variable . 



B_CALL 
LD 

RST 



JR 

CALL 
JR 



C, skip 

Nz If Archived 

Z, skip 

Arc_Unarc 



Nz If Archived : 



LD 



OR 
RET 



A, B 

A 



B has page information, NZ 
if archived. 
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ChkFindSym 



Category: 
Description: 



Inputs: 

Registers: 

Flags: 
Others: 
Outputs: 

Registers: 



Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Memory 

Searches the symbol table structure for a variable. 

This particular search routine must be used if the variable to search for is 
either a Program, AppVar, or Group. It will also work for variables of other 
types as long as the data type in OP1 input is correct. 

This is used to determine if a variable is created and also to return pointers to 
both its symbol table entry and data storage area. 
This will also indicate whether or not the variable is located in RAM or has 
been archived in Flash ROM. 



(OP1) = one-byte, data type of variable to search for. 

This routine will fail if this data type is not correct. 
(OP1 + 1) to (OP1 + 8) = variable name 

None 

None 



CA flag = 1 if symbol was not found 
= 0 if symbol was found 

Also if found: 

ACC lower 5 bits = data type 

ACC upper 3 bits = system flags about variable, do "AND 1 Fh" to get type only 
B = 0 if variable is located in RAM else variable is archived 
B = ROM page located on 

If variable is archived then its data cannot be accessed directly, it must be 

unarchived first. 
HL = pointer to the start of the variables symbol table entry 
DE = pointer to the start of the variables data area if in RAM 

None 

OP1 = variable name 
All 



This will not find system variables that are preallocated in system RAM such 
as Xmin, Xmax etc. Use RclSysTok to retrieve their values. 

Note: ChkFindSym will not find Applications. 

(continued) 
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ChkFindSym (continued) 

Example: 



Look for AppVar MYAPPVAR in the symbol table. 
If it exists and is archived then unarchive it and relook it up. 

If it does not exist ; create it with a size of 100 ; bytes. 

Relook : 



VarCreated : 



LD 



_CALL 
_CALL 



JR 



LD 



_CALL 



PUSH 

PUSH 

B_CALL 

POP 

POP 

JR 

LD 
OR 
JR 

B_CALL 
JR 

RET 



HL, VarName 
Mov9ToOPl 
ChkFindSym 
NC, VarCreated 

HL, 100 

CreateAppVar 



HL 
DE 

OP4ToOPl 

DE 

HL 

Done 

A, B 

A 

Z, done 

Arc_Unarc 

Relook 



OP1 = variable name 
look up 

jump if it exists 

size to create at 

create it, HL = pointer to 

sym entry, DE = pointer to 

data 

save during move 
OP1 = name 
restore 



check for archived 

in RAM ? 

yes 

unarchive if enough RAM 
look up pointers again in 
RAM now done : 



VarName : 



DB 



AppVarObj, 'MYAPPVAR' , 0 
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CleanAII 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 
Example: 



Memory 

Deletes all temporary variables from RAM. 



None 
None 
None 



None 
None 

Temporary variables are all deleted 
All 



This routine should only be used when there are no temporary variables that 
exist and are still being used. See the Temporary Variables section in 
Chapter 2 for further information. See the Parselnp and MemChk routines. 
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CloseProg 



Category: 
Description: 

Inputs: 

Registers: 



Flags: 
Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Memory 

This routine is used after EditProg to return unused RAM back to free RAM. 
The size bytes of the variable are updated by this routine. An application 
should not update them. 



Each of these are two-bytes: 



= pointer to the start of the variables data storage area 

= pointer to the byte following the variable data, this will be used 
to calculate the new size of the variable 

= pointer to the byte AFTER the last byte of free RAM inserted 

= size of RAM block moved to allow the RAM to be inserted 
DO NOT CHANGE THIS VALUE. 



(iMathPtrl) 
(iMathPtr2) 

(iMathPtr3) 
(iMathPtr4) 

None 
None 

None 
None 

The variable's size is changed. Unused RAM returned to free RAM. Normal 
allocating and deallocating of RAM can resume. 

All 
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CmpSyms 



Memory 

Compares Name @HL with Name @DE. 



Category: 
Description: 
Inputs: 

Registers: HL = end of first name in RAM 

DE = end of second name in RAM 
B = length of name 

Flags: None 

Others: None 

Outputs: 

Registers: C = number of letters that match 
C = original B if all letters match 



Flags: 

Others: 

Registers 
destroyed: 

Remarks: 
Example: 



Carry set if Sym2 (HL) > Sym1 (DE) 
None 

AF, BC, DE, HL 

The names must be the same size. The name lengths should have already 
been compared before calling this routine. 



name last 


used for the Xlist 


variable in statistics is 


ZEBRA" 






LD 


HL, StZebra 




RST 


rMov9ToOPl ; 


Move 9 bytes to OPl: 






"ZEBRA" + junk 


LD 


DE, 0P1+4 




LD 


HL, StatX+4 




LD 


B, 5 ; 


compare 5 bytes 


B_CALL 


CmpSyms ; 


If C = 5 then OPl = StatX 






name 


LD 


A, C 




CP 


5 




JR 


Z, Match 




JR 


NoMatch 




StZebra : 


DB "ZEBRA" 
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CreateOEqu 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Creates an equation variable of size 0 in RAM. 

None 
None 

OP1 = name of equation to create 

HL = pointer to variable's symbol table entry 

DE = pointer to variable's data storage, size bytes 

None 

OP4 = variable's name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization is done, assume random. See section on 
Creating Variables. 

Create an empty Y1 equation. 



LD 
RST 

B CALL 



HL, Ylname 

rMov9ToOPl 

CreateOEqu 



OP1 = name 

if returns then variable created 



Ylname : 



['3 



EquOb j, tVarEqu, tYl, 0, 0 
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CreateAppVar 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Creates an AppVar variable in RAM. 

HL = size of AppVar to create in bytes 
None 

OP1 = name of AppVar to create 



HL = pointer to variable's symbol table entry 

DE = pointer to variable's data storage, size bytes 

None 

OP4 = variable's name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization is done, assume random. Users can only delete 
and link AppVars. They are intended for Apps to use for state saving upon 
exiting. See section on Creating Variables. 

Create AppVar DOG, 50 bytes in size. 



LD 

RST 



HL, DOGname 
rMov9ToOPl 



OP1 



LD 



_CALL 



HL, 50 

CreateAppVar 



if returns then variable 
created 



DOGname : 



D 3 



AppVarObj, 'DOG' , 0 
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CreateCList 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Creates a complex list variable in RAM. 

HL = number of elements in the list 
None 

OP1 = name of list to create 

HL = pointer to variable's symbol table entry 

DE = pointer to variable's data storage, size bytes 

None 

OP4 = variable's name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization of the elements is done, assume random. See 
section on Creating Variables. 

Create complex list L1 with 50 elements. 



LD 

RST 



LD 



CALL 



HL, Llname 

rMov9ToOPl ; OP1 = name 
HL, 50 

CreateCList ; if returns then variable 
; created 



Llname : 



['3 



CListOb j, tVarLst, tLl, 0, 0 
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CreateCplx 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Creates a complex variable in RAM. 

None 
None 

OP1 = name of complex to create 

HL = pointer to variable's symbol table entry 
DE = pointer to variable's data storage 

None 

OP4 = variable's name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. This should not be used to create temp storage space, 
A-Z or THETA. No initialization is done, assume random. See section on 
Creating Variables. 



Create complex A. 



LD 

RST 



HL, Aname 
rMov9ToOPl 



OP1 



_CALL 



CreateCplx 



if returns then variable 
created 



Aname : 



DB 



CplxObj, 'A' , 0, 0 
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CreateEqu 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Creates an equation variable in RAM. 

HL = size of equation to create in bytes 
None 

OP1 = name of equation to create 

HL = pointer to variable's symbol table entry 

DE = pointer to variable's data storage, size bytes 

None 

OP4 = variable's name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization is done, assume random. See section on 
Creating Variables. 

Create Y1 equation 50 bytes in size. 



LD 

RST 



LD 



CALL 



Ylname : 



E'3 



HL, Ylname 

rMov9ToOPl ; OP1 = name 
HL, 50 

CreateEqu ; if returns then variable created 
EquOb j, tVarEqu, tYl, 0, 0 
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CreatePair 



Category: 
Description: 



Inputs: 

Registers: 

Flags: 
Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Creates a pair of parametric graph equations. 

There should never be a situation where only 1 of a pair of parametric 
equations is created without the other. This routine will check that there is 
enough memory to create both equations before creating any. 



HL = size to create the equation specified in OP1 , either xt or yt. The member 
of the pair not specified will be created empty. 

None 

OP1 = pair member name to create with the specified size 



HL = size of pair member specified 
None 

OP1 = pair member name specified 
OP4 = pair member name not specified 

OP1 and OP2 



Memory error if not enough free RAM to create the pair. 

If xt# is specified then yt# is created empty. If yt# is specified then xt# is 

created empty. 

No checks are made for duplicate or valid names. No initialization is done, 
assume random. See section on Creating Variables. 

Create parametric pair of equations xt1 and yt1 , yt1 at size 50. 



LD 

RST 



LD 



CALL 



HL, ytlname 

rMov9ToOPl ; OP1 = name 
HL, 50 

CreatePair ; if returns then variables 

; created 

; OP1 = ytl, OP4 = xtl, HL = 50 



ytlname : 



DB 



EquOb j, tVarEqu, tylt, 0, 0 
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CreatePict 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed 

Remarks: 



Example: 



Memory 

Creates a picture variable in RAM. 

None 
None 

OP1 = name of picture to create 

HL = pointer to variable's symbol table entry 

DE = pointer to variable's data storage, size bytes 

None 

OP4 = variable's name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. The size of a Pic var is 756 bytes, it does not allocate space for 
the last row of pixels, that row is never used by the system graph routines. 

If you need to save a bitmap of the entire display to a variable then an AppVar 
should be used. The only drawback to using an AppVar is that the Pic could 
not be displayed by the user when the app is not executing. 

No initialization is done, assume random. See section on Creating Variables. 

Create Pic Pic1 . 



LD 

RST 



CALL 



HL, Piclname 
rMov9ToOPl 

CreatePict 



OP1 = name 

if returns then variable 
created 



Piclname : 



03 



PictObj,tVarPict,tPicl, 0, 0 
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CreateProg 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Creates a program variable in RAM. 

HL = size of program to create in bytes 
None 

OP1 = name of program to create 

HL = pointer to variable's symbol table entry 

DE = pointer to variable's data storage, size bytes 

None 

OP4 = variable's name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization is done, assume random. See section on 
Creating Variables. 

Create Program DOG, 50 bytes in size. 



LD 

RST 



LD 



_CALL 



HL, DOGname 
rMov9ToOPl 

HL, 50 

CreateProg 



; OP1 



; if returns then 
; variable created 



DOGname : 



ProgOb j , ' DOG ' , 0 
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CreateProtProg 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Creates a protected program variable in RAM. 

HL = size of program to create in bytes 
None 

OP1 = name of program to create 

HL = pointer to variable's symbol table entry 

DE = pointer to variable's data storage, size bytes 

None 

OP4 = variable's name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization is done, assume random. Users cannot delete or 
edit protected programs, they can be deleted from an application. See section 
on Creating Variables. 

Create protected Program DOG, 50 bytes in size. 



LD 

RST 



HL, DOGname 
rMov9ToOPl 



; OP1 = name 



LD 



CALL 



HL, 50 

CreateProtProg ; if returns then variable 
; created 



DOGname : 



E'3 



ProtProgObj, 'DOG',0 
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CreateReal 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Creates a real variable in RAM. 

None 
None 

OP1 = name of real to create 



HL = pointer to variable's symbol table entry 
DE = pointer to variable's data storage 

None 

OP4 = variable's name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. This should not be used to create temp storage space, only A-Z 
and theta. No initialization is done, assume random. See section on Creating 
Variables. 



Create real A. 



LD 

RST 



_CALL 



HL, Aname 
rMov9ToOPl 

CreateReal 



; OP1 = name 

; if returns then variable 
; created 



Aname : 



DB 



RealObj, ' A' , 0, 0 
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CreateRList 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Creates a real list variable in RAM. 

HL = number of elements in the list 
None 

OP1 = name of list to create 

HL = pointer to variable's symbol table entry 

DE = pointer to variable's data storage, size bytes 

None 

OP4 = variable's name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization of the elements is done, assume random. See 
section on Creating Variables. 

Create real list CAT with 50 elements. 



LD 

RST 



LD 



CALL 



HL, CATname 

rMov9ToOPl ; OP1 = name 
HL, 50 

CreateRList ; if returns then variable 
; created 



CATname : 



['3 



ListObj, tVarLst, ' CAT' , 0 
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CreateRMat 



Category: Memory 

Description: Creates a real matrix variable in RAM. 
Inputs: 

Registers: HL = dimension of matrix, (row, col), 99 is maximum row or column 

Flags: None 

Others: OP1 = name of matrix to create 
Outputs: 

Registers: HL = pointer to variable's symbol table entry 

DE = pointer to variable's data storage, dimension 



Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



None 

OP4 = variable's name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization of the elements is done, assume random. See 
section on Creating Variables. 

Create matrix [A] with 5 rows and 8 columns. 



LD 

RST 



HL, MatAname 
rMov9ToOPl ; OP1 



LD 



_CALL 



HL, 5*256+8 ; 5 x 8 

CreateRMat ; if returns then variable 
; created 



MatAname : 



MatOb j , tVarMat , tMat A, 0 , 0 
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CreateStrng 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Creates a string variable in RAM. 

HL = number bytes in string 
None 

OP1 = name of string to create 

HL = pointer to variable's symbol table entry 

DE = pointer to variable's data storage, size bytes 

None 

OP4 = variable's name 
OP1 and OP2 

Memory error if not enough free RAM. No checks are made for duplicate or 
valid names. No initialization of the string contents is done, assume random. 
See section on Creating Variables. 

Create string Str1 100 bytes in length. 



LD 

RST 



LD 



CALL 



HL, Strlname 
rMov9ToOPl 

HL, 100 
CreateStrnq 



OP1 = name 

size of string 

if returns then variable 

created 



Strlname : 



03 



StrngObj,tVarStrng,tStrl, 0, 0 
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DataSize 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 
Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Computes the size, in bytes, of the data portion of a variable in RAM. 



ACC = data type 

HL = pointer to first byte of data storage 

None 

None 



DE = size of data storage in bytes 
HL = intact 

None 

None 

A, BC 



This routine cannot be used on archived variables or applications. 

If the variable's data area has size information, like a list has two-bytes for 
number of elements, then those bytes are included in the computation. 

; Find the size in bytes of the data area for list LI. 
LIName : 



DB 


ListObj,tVarLst,tLl, 0, 0 


LD 


HL, Llname 




RST 


rMov9ToOPl 


OP1 = LI 


B_CALL 


FindSym 


find in symbol table, 






DE = pointer to data 


AND 


lFh 


ACC = data type information, 






real or complex list 


EX 


DE, HL 


HL = pointer to data storage 


B_CALL 


DataSize 


DE = size of data storage 






If LI were a real list with 5 






elements then the size 






returned would be 47 bytes. 



5 elements *S 
2 size bytes 



for each 



45 

2 

47 
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DataSizeA 

Category: Memory 

Description: Computes the size, in bytes, of the data portion of a variable that has two size 
bytes as part of its data storage. 

This routine applies to equations, lists, matrices, programs, AppVars. 

Inputs: 

Registers: ACC = data type 

BC = two byte size information: dimension, number of bytes, number of 
elements 

Flags: None 
Others: None 
Outputs: 

Registers: DE = size of data storage in bytes 

Flags: None 

Others: None 

Registers All 
destroyed: 

Remarks: If the variable's data area has size information, like a list has two bytes for 
number of elements, then those bytes are included in the computation. 

Example: ; Find the size in bytes of a complex list with 5 elements: 

LD A,CListObj ; ACC = data type information, 

; cplx list 

LD BC, 5 ; number elements 



_CALL 



DataSizeA 



5 elements *18 for each = 90 
2 size bytes = 2 



DE 



size of data storage 
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DeallocFPS 

Category: Memory 

Description: Removes space in nine-byte chunks from the Floating Point Stack. 
Inputs: 

Registers: HL = number of chunks to remove 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: FPS (Floating Point Stack top) decreased by HL 9 

Registers DE, HL 
destroyed: 

Remarks: No values are removed from the deallocated space. 
Example: 
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DeallocFPSI 

Category: Memory 

Description: Removes space in bytes from the Floating Point Stack. 
Inputs: 

Registers: DE = number of bytes to remove 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: FPS (Floating Point Stack top) decreased by HL 

Registers HL 
destroyed: 

Remarks: No values are removed from the deallocated space. 
Example: 
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Del Mem 

Category: 
Description: 

Inputs: 

Registers: 

Flags: 
Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Memory 

Deletes RAM from an existing variable. This routine will only delete the RAM. If 
the variable deleting from has a size field, it is NOT UPDATED. Updating must 
be done by the application. 



HL = address of first byte to delete 
DE = number of bytes to delete 

None 

None 



DE = intact 

BC = amount deleted 

RAM deleted 

None 

None 

All 



See InsertMem routine. 

(continued) 
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Del Mem (continued) 

Example: Delete 1 0 bytes at the beginning of an AppVar. 



LD 
RST 

B_CALL 
JR 



HL, AppVarName 
rMov9ToOPl 
ChkFindSym 
NC, Created 



; 0P1 = name of AppVar 
; look up in symTable 
; jump if it exists 



B_JUMP ErrUndefined 
DE = pointer to size bytes of AppVar 
Created : 



PUSH 



DE 



; error if not there 



; save pointer to start of 
; size bytes of data 



INC 
INC 



DE 
DE 



; move DE to 1st byte of 
; AppVar Data 



LD 

EX 



CALL 



HL, 10 
DE, HL 

DelMem 



; number bytes to insert 

; HL = pointer to start of 

; delete, DE number bytes 

; delete the memory 



POP 
PUSH 



HL 
HL 



; HL = pointer to size bytes 
; save 



B CALL 



ldHLind 



; HL = size of AppVar, 
; number bytes 



XOR 



; clear CA 



LD 

SBC 



BC, 10 
HL, BC 



; deer by amount deleted 



EX 
POP 



DE, HL 
HL 



; pointer to size bytes 
; location 



LD 

INC 

LD 



(HL) ,E 
HL 

(HL) ,D 



; write new size. 



AppVarName : DB 



AppVa r Ob j , ' AVAR ' , 0 
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DelVar 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Deletes a variable stored in RAM. 

All of the inputs for this routine are the outputs of FindSym and ChkFindSym. 
It is common to call one of these routines and then call DelVar immediately 
after. 

HL = pointer to start of symbol table entry of variable 
DE = pointer to start of data storage of variable 

B = 0 if variable resides in RAM else it is the page in the archive it is stored 

None 

None 



None 
None 
None 
All 



OP1 - OP6 are preserved. 

Variable's symbol entry and data are deleted. 

Graph is marked dirty if variable was used during graphing. 

All global memory pointers are adjusted. 

Error if the variable resides in the archive. 

; Delete the variable 'A' if it exists 

LD HL, AName 

RST rMov9ToOPl ; OP1 = variable a 

} 

B_CALL FindSym ; look up 

JR C, Deleted ; jump if variable is not 

; created 



Deleted : 
AName : 



CALL DelVar 



DB RealObj, 'A' , 0, 0 
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DelVarArc 



Category: 

Description: 

Inputs: 

Registers: 



Flags: 
Others: 
Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

Remarks: 

Example: 



Memory 

Deletes a variable from RAM or the archive. 



HL = pointer to symbol table entry of variable to delete 
DE = pointer to start of data for variable 
B = archived status 

0 = RAM otherwise the ROM page in Flash for the variable 

None 

None 



None 
None 

Variable's symbol entry and data deleted if in RAM, otherwise the symbol table 
entry is only deleted and the variable data is marked for deletion on the next 
garbage collection. 

Graph is marked dirty if variable was used during graphing. 

All global memory pointers are adjusted. 

All 

See DelVar and DelVarNoArc routines. 
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DelVarNoArc 



Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Memory 

Deletes variable from RAM. 
No archive checking performed. 

HL = pointer to symbol table entry of variable to delete 
DE = data pointer to data 

None 

None 



None 

Regraph flag set if varGraphRef flag of symbol was set. 

None 

All 

See DelVar for more information. 

This routine should only be called if you are sure that your variable will never 
be archived. Generally, it is better to use the DelVarArc or DelVar routines. 

Variable's symbol entry and data are deleted. 

Graph is marked dirty if variable was used during graphing. 

All global memory pointers are adjusted. 

Error if the variable resides in the archive. 



Example: 



; Delete the variable 'A' if it exists: 



LD 

RST 



HL, Aname 
rMov9ToOPl 



OP1 = variable a 



CALL 



JR 



FindSym 
C, Deleted 



look up 

jump if variable is not 
created 



Deleted : 
Aname : 



B CALL 



D3 



DelVarNoArc 



RealObj, 'A' , 0, 0 
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EditProg 



Category: 
Description: 



Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

Remarks: 



Memory 

This routine will insert all of free RAM into a Program, Equation, or AppVar. 
The intent is for the variable to be able to be edited without having to 
continuously allocate and deallocate memory. Once the edit is completed, a 
call to CloseProg is made to return what is not used back to free RAM. 



DE = pointer to start of variables data storage area 

None 

None 

None 
None 

Each of following are two-bytes: 



(iMathPtrl) 
(iMathPtr2) 
(iMathPtr3) 
(iMathPtr4) 
All 



pointer to the start of the variables data storage area. 

THIS MUST STAY INTACT WHILE THE EDIT IS IN SESSION. 

pointer to the byte following the variable data. This is the next 
location the data area can grow into. 

pointer to the byte AFTER the last byte of free RAM inserted. 
The data being input cannot be written into this RAM location. 

size of RAM block moved to allow the RAM to be inserted. 
DO NOT CHANGE THIS VALUE. 



The application can must change the pointer value in (iMathPtr2) as the 
variables data size grows or shrinks. This value is needed by the close routine. 

No memory allocation/deallocation can be done in this state. 

Contents of variables may by copied or changed, but not their sizes. 

The Floating Point Stack may be copied to/from, but not grown or shrunk. 

The hardware stack may change, calls, RET, push, and pop. 



Example: 
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EnoughMem 



Category: Memory 

Description: Checks if an imputed amount of RAM is available. This routine will also 
attempt to free RAM that is taken by temporary variables that have been 
marked dirty but not yet deleted. 

Inputs: 

Registers: HL = amount of RAM to check for being available 
Flags: None 
Others: None 
Outputs: 

Registers: DE = amount of RAM to check for being available 
Flags: CA = one (set) if there is insufficient RAM available 
Others: None 
All 



Registers 
destroyed: 

RAM used: 

Remarks: 



None 

No error is generated. 
See MemChk. 



Example: 
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Exch9 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 
Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Memory 

Exchanges (swaps) two nine-byte blocks of memory. 



DE = address of start of one nine-byte block 
HL = address of start of second nine-byte block 

None 

None 



None 
None 

Nine bytes originally at DE are now at original HL 
Nine bytes originally at HL are now at original DE 

A, BC, DE, HL 



None 
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ExLp 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 
Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Memory 

Exchanges blocks of memory of up to 256 bytes. 



B = number of bytes; 0 = 256 

DE = address of start of one nine-byte block 

HL = address of start of second nine-byte block 

None 

None 



None 
None 

Block originally at DE is now at original HL 
Block originally at HL is now at original DE 

A, BC, DE, HL 



None 
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FindAlphaDn 

Memory 



Category: 
Description: 



This is used to search the symbol table, for all of the variables of a certain 
type, alphabetically in descending order. 

Each call to this routine returns the variable name preceding the one input in 
OP1. 



Inputs: 

Registers: None 
Flags: None 
Others: 



OP1 = variable name to find the previous before, usually output from the last 
call to this routine. 

(OP1) must have the type of variable searching for set. 

The name input in order to have the very last name for a certain type varies by 
the variable's type: 

Real, Complex, Programs, AppVars, Group Vars: 



OP1 


+1 


+2 


+3 


+4 


+5 


+6 


+7 


+8 


Object 
Type 


OFEh 


? 


? 


? 


? 


? 


? 


? 



All other types: 



OP1 


+1 


+2 


+3 


+4 


+5 


+6 


+7 


+8 


Object 
Type 


variable 
token 


OFEh 


? 


? 


? 


? 


? 


? 



Outputs: 

Registers: If a previous variable name is found then: 

HL = pointer to the symbol table entry of the variable found 

CA = 0 if a previous variable name was found 
= 1 if no previous variable name exists 



Flags: 
Others: 



Registers 
destroyed: 



If a previous variable name is found then: 
OP1 and OP3 = the variable name found 

Otherwise : 

OP1 = variable name input 
All 

(continued) 
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FindAlphaDn (continued) 



RAM used: OP2, OP3 

upDownPtr — two byte pointer 

Remarks: ProgObj, ProtProgObj, and TempProgObj are grouped together. 
ListObj and CListObj are grouped together. 
NewEquObj and EquObj are grouped together. 
See FindAlphaUp, SrchVLstUp, SrchVLstDn. 

Example: Find all of the programs that are currently created, search alphabetically in 
descending order. 



FindPrograms : 



_CALL 



LD 
LD 
LD 



LD 



FindLoop : 



_CALL 



RET 



0P1 = next list name 



JR 



ZeroOPl 
A, ProgObj 
(0P1) , A 
A, OFEh 



(OP1+1) , A 
FindAlphaDn 

C 



FindLoop 



looking for a list 
name = FEh, so the last 
program alphabetically is 
found 



see if find another program 
name 

return if no more program 
names found yet 



; find previous using one just 
; found as input 
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FindAlphaUp 

Memory 



Category: 
Description: 



This is used to search the symbol table, for all of the variables of a certain 
type, alphabetically in ascending order. 

Each call to this routine returns the next variable name following the one input 
in OP1. 



Inputs: 

Registers: None 
Flags: None 
Others: 



OP1 = variable name to find the next after, usually output from the last call to 
this routine. 

(OP1) must have the type of variable searching for set. 

The name input in order to have the very first name for a certain type varies by 
the variable's type: 

Real, Complex, Programs, AppVars, Group Vars: 



OP1 


+1 


+2 


+3 


+4 


+5 


+6 


+7 


+8 


Object 
Type 


00 


? 


? 


? 


? 


? 


? 


? 



All other types: 



OP1 


+1 


+2 


+3 


+4 


+5 


+6 


+7 


+8 


Object 
Type 


variable 
token 


OFFh 


? 


? 


? 


? 


? 


? 



Outputs: 

Registers: If a next variable name is found then: 

HL = pointer to the symbol table entry of the variable found 



Flags: 
Others: 



Registers 
destroyed: 



CA = 0 if a next variable name was found 
= 1 if no next variable name exists 

If a next variable name is found then: 
OP1 and OP3 = the variable name found 

Otherwise: 

OP1 = variable name input 
All 

(continued) 
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FindAlphaUp (continued) 



RAM used: 
Remarks: 

Example: 



OP2, OP3 
upDownPtr 



two byte pointer 



ProgObj, ProtProgObj and TempProgObj are grouped together. 
ListObj and CListObj are grouped together. 
NewEquObj and EquObj are grouped together. 
See FindAlphaDn, SrchVLstUp, SrchVLstDn. 

Find all of the lists that are currently created, search alphabetically in 
ascending order. 



FindLists : 



_CALL 



LD 
LD 
LD 
LD 
LD 



LD 



FindLoop : 



B_CALL 
RET 



0P1 



next list name 



JR 



ZeroOPl 
A, ListObj 

(0P1) , A 
A, tVarLst 

(0P1+1) , A 
A, OFFh 



(0P1+1) , A 

FindAlphaUp 
C 



FindLoop 



looking for a list 
list designator token 

set name to FFh, so that the 
first list alphabetically is 
found 



see if find another list name 
return if no more list names 
not found yet 



find next using one just found 
as input 
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FindApp 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Memory 

Searches for an application that may be stored in Flash ROM. 



None 
None 

OP1 = name of application to search for 



A = ROM page application starts on if found 

CA = 0 if application exists 

CA = 1 if application does not exist 

None 

All 



appSearchPage (two-bytes) 
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FindAppNumPages 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Memory 

Finds the number of 16K pages an application uses in archive memory 

A = first page of application 

None 

None 



A = first page of application 

C = number of 16K pages the application uses 

None 

None 

BC, DE 

If an application was not found on the given page, C will equal 0. 



IN 



CALL 



A, (memPageAPort ) 



FindAppNumPages 



LD 



A, C 



gets the current memory 
page for app . Make sure 
this is on the first page 
of a multi-page 
application . 

finds the total number of 
pages the application 
uses in archive memory. 
A = number of pages 



For multi-page apps, create a routine that will reside on the first page of the 
application that will return the memory page, 
i.e., Get_First_Page: 



IN 



RET 



A, (memPageAPort) 



get the memory page of 
the first application 
page . 
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FindAppDn 



Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 



Outputs: 

Registers: 
Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Memory 

Searches for the next application in Flash ROM whose name is alphabetically 
less than the name in OP1 . 



None 
None 

OP1 = the name to find an application less than 

If searching for all of the application names in descending alphabetical order 
then this name is either the previous one found or the initial name used to start 
the search. 

To initialize the search to find the last application name alphabetically, set 
(OP1 + 1) = OFEh. 

None 

CA = 1 if no application with a lesser name exists. The previous found is the 
first alphabetically. 

CA = 0 if an application less than OP1 was found. 

OP1 = application name found if one exists. 

All 

OP2, OP3, appSearchPage (two-bytes) 

No information about what ROM page the application resides on is returned. 
To get this information a FindApp needs to be done. 

A loop that finds all of the application names in descending order. 



CALL 



LD 
LD 



ZerroOPl 
A, OFEh 
OP1+1) , A 



initialize OP1 for 1st search 

set OP1 = name > any valid 
name 



loop : 



B_CALL FindAppDn ; look for next lesser 

; alphabetically 

JR NC, loop ; jump if found one, go look for 

; next one 



RET 
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FindAppUp 



Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 



Outputs: 

Registers: 
Flags: 



Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Memory 

Searches for the next application in Flash ROM whose name is alphabetically 
greater than the name in OP1 . 



None 
None 

OP1 = the name to find an application greater than 

If searching for all of the application names in ascending alphabetical order 
then this name is either the previous one found or the initial name used to start 
the search. 

To initialize the search set OP1 = all O's with a system call to ZeroOPI . 



None 

CA = 1 if no application with a greater name exists. The previous found is the 
last alphabetically. 

CA = 0 if an application greater than OP1 was found 

OP1 = application name found if one exists 

All 

OP2, OP3, appSearchPage (two-bytes) 

No information about what ROM page the application resides on is returned. 
To get this information a FindApp needs to be done. 

A loop that finds all of the application names in ascending order. 



loop : 



_CALL 
_CALL 



JR 



ZerroOPl ; initialize OP1 for 1st search 

FindAppUp ; look for next higher 

; alphabetically 

NC, loop ; jump if found one, go look for 

; next one 



RET 
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FindSym 



Category: 
Description: 



Inputs: 

Registers: 



Memory 

Searches the symbol table structure for a variable. 

This search routine is used to find variables that are not programs, AppVar, or 
Groups. See ChkFindSym. 

This is used to determine if a variable is created and also to return pointers to 
both its symbol table entry and data storage area. 
This will also indicate whether or not the variable is located in RAM or has 
been archived in Flash ROM. 



(OP1 + 1) to (OP1 + 6) = variable name 

See documentation on variable naming conventions. 



Flags: None 

Others: None 
Outputs: 

Registers: CAflag 



1 if symbol was not found 
0 if symbol was found 



If symbol is found, additional outputs are: 
ACC lower 5 bits = data type 

ACC upper 3 bits = system flags about variable. Mask via "AND" with a 

value of 1 Fh to obtain data type only. 
B = 0 if variable is located in RAM else variable is archived 
B = ROM page located on 

If variable is archived then its data cannot be accessed directly, it 

must be unarchived first. 

pointer to the start of the variables symbol table entry 
pointer to the start of the variables data area if in RAM 



HL 
DE 



Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



None 

OP1 = variable name 
All 

This will not find system variables that are preallocated in system RAM such 
as Xmin, Xmax etc. Use RclSysTok to retrieve their values. 

This will not find applications. 

(continued) 
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FindSym (continued) 



Example: 



Look for List LI in the symbol table. 

If it exists and is archived then unarchive it and relook it up. 
If it does not exist create it as a real list of 10 elements. 
Relook : 

LD HL, Llname 

B_CALL Mov9ToOPl 
B_CALL FindSym 

NC, VarCreated 



JR 
LD 

B_CALL 
PUSH 
PUSH 
B_CALL 

POP 
POP 
JR 



OP1 = variable name 
look up 

jump if it exists 



HL, 10 

CreateRList 

HL 

DE 

OP4ToOPl 

DE 

HL 

Done 



size to create at data 



save durinc 
OP1 = name 
restore 



VarCreated : 



LD 
OR 
JR 



A, B 

A 

Z, DONE 



check for archived 

in RAM ? 

yes 



DONE : 



CALL 



JR 



RET 



Arc_Unarc 
Relook 



unarchive if enough RAM 
look up pointers again in 
RAM now 



Llname : 



['3 



ListObj,tVarLst,tLl, 0 
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FixTempCnt 



Category: Memory 

Description: Resets pTempCnt back to a input value, and delete all temps with name 
counters greater than or equal to that value. 

Inputs: 

Registers: DE = value to pTempCnt to 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: (pTempCnt) = DE 

All temps created with pTempCnt >= input DE are deleted. For example, if 
input DE = 5 then temps with counter value 5 or greater $0500 will be deleted. 
$0600... 

Registers All 
destroyed: 

RAM used: pTempCnt 

Remarks: See the Temporary Variables section in Chapter 2. Also, see the CleanAII 
routine. 

Example: 
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FlashToRam 



Category: 

Description: 

Inputs: 

Registers: 



Flags: 
Others: 



Memory 

Copies bytes from Flash to RAM. 



A = page of source (Flash) 
HL = offset of source (Flash) 
DE = RAM location of destination 
BC = number of bytes to copy 

None 

None 



Outputs: 

Registers: None 

Flags: None 

Others: None 



Registers 
destroyed: 

Remarks: 



Example: 



Certain pages in Flash cannot be copied. This routine will wrap to the next 
page if the offset = 8000h. A will be incremented to the next page, and HL wil 
be reset to 4000h, and the copying will go on. 
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InsertMem 



Category: 
Description: 



Memory 

Inserts RAM into an existing variable. 



This routine will only insert the RAM — it stays uninitialized and if the variable 
inserting into has a size field, it is NOT UPDATED. Updating must be done by 
the application. 

A check for enough free RAM must be done by the application. This routine 
assumes the RAM is available. 



Inputs: 

Registers: HL = number of bytes of RAM to insert, no check is made for enough free 



DE = point of insertion address — this cannot be the first byte of the variable's 
data — if it is, its symbol table entry will not have the correct pointer to 
the data. 



RAM. 



Flags: 



None 



Others: 



None 



Outputs: 

Registers: 
Flags: 



None 



DE = intact, the point of insertion address 



Others: 



RAM inserted into variable. 



Registers 
destroyed: 



All 



Remarks: 



See DelMem. 



(continued) 
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InsertMem (continued) 



Example: Insert 1 0 bytes at the beginning of an Application Variable. 



LD 



_CALL 



HL, 10 

ErrNotEnoughMem 



number bytes to insert 
error if 10 bytes are not 
free 



LD 
RST 

B_CALL 
JR 



HL, AppVarName 
rMov9ToOPl 
ChkFindSym 
NC, Created 



OP1 = name of AppVar 
look up in symTable 
jump if it exists 



B_JUMP ErrUndefined 
DE = pointer to size bytes of AppVar 
Created : 



PUSH 



DE 



error if not there 



save pointer to start of 
size bytes of data 



INC 
INC 



DE 
DE 



move DE past size bytes 



LD 



_CALL 



HL, 10 
InsertMem 



number bytes to insert 
insert the memory 



POP 
PUSH 



HL 
HL 



HL = pointer to size bytes 
save 



_CALL 



LD 
ADD 



LdHLInd 

BC, 10 
HL, BC 



HL = size of AppVar, 
number bytes 

increase by 10, amount 
inserted 



EX 
POP 



DE, HL 
HL 



pointer to size bytes 
location 



LD 

INC 

LD 



(HL) , E 
HL 

(HL) ,D 



write new size. 



AppVarName : DB 



AppVarObj, 'AVAR' , 0 
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LdHLInd 

Category: Memory 

Description: Loads register pair HL with the contents of memory pointed to by (HL). 

Inputs: 

Registers: HL = address. 

Flags: None 

Others: None 

Outputs: 

Registers: H = (HL+1) 

L = (HL) 

Flags: None 

Others: None 

Registers A, HL 
destroyed: 

Remarks: 

Example: Same as: 



LdHLInd: 



LD A, (HL) 

INC HL 

LD H, (HL) 

LD L, A 

RET 
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LoadClndPaged 



Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 
Example: 



Memory 

Reads a byte of data from any ROM page. Main use is for applications to read 
data from variables that are archived, without having to unarchive them to 
RAM first. 



B = ROM page to read byte from 
HL = address of byte on the ROM page, 
(4000h-7FFFh) 

None 
None 



C = byte of data from input ROM page and Offset 

None 

None 

C 

B, HL are not changed. See the LoadDEIndPaged routine. Also, see the 
Accessing Archived Variables Without Unarchiving section in Chapter 2. 

Read the byte of data from ROM page OCh, address 4006h. 



LD 
LD 



B, Och 
HL, 4006h 



; ROM page 
; offset 



B_CALL LoadClndPaged ; C = byte 

RET 
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LoadDEIndPaged 



Category: 
Description: 

Inputs: 

Registers: 

Flags: 
Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Read two consecutive bytes of data from any ROM page. The main use of this 
routine is for applications to read data from variables that are archived, without 
having to unarchive them to RAM first. 



B = ROM page of first of two bytes to read 
HL = address of byte on the ROM page, 
(4000h-7FFFh) 

None 
None 



E = first byte read 
D = second byte read 

None 

None 

DE, C 

B, HL are set to the address of the second byte read. If the second byte of 
data is not on the same ROM page as the first, the switch to the next ROM 
page is handled. See the LoadClndPaged routine. Also, see the Accessing 
Archived Variables Without Unarchiving section in Chapter 2. 

Read two bytes of data from ROM page OCh, address 4006h. 



LD 
LD 



B_CALL 
RET 



B, Ooh 
HL, 4006h 

LoadDEIndPaged 



ROM page 
offset 

D = byte @ (4007h) , 
E = byte @ (4006h) 
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MemChk 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Returns the amount of RAM currently available. 

None 
None 
None 

HL = amount of RAM available, in bytes 

None 

None 

BC, HL 

If a system editor is open, this will always return 0 bytes available. System 
edits use all of free RAM during the edit. 

The amount returned may be inaccurate if there are any temporary variables 
that are marked as dirty but not yet deleted. There are two ways/options to 
solve this: 

- The routine CleanAII can be used to remove all temporary 
variables. This is fine as long as an application is not using 
temporary variables. Temporary variables are returned by the 
parser if the result is not RealObj or CplxObj, make sure that 
none are still in use. 

Use the routine EnoughMem instead, it will delete only temps 
that are marked dirty. 

Delete all temporary variables and then check if there is at least 100 bytes 
available. 



B_CALL 


CleanAII 


; delete all temporary 






; variables 


B_CALL 


MemChk 


; HL = amount of mem free 


LD 


DE, 10 0 




OR 


A 


; CA = 0 


SBC 


HL, DE 


; if CA = 1 then less than 






; bytes are available 


JR 


C,Not_100 


; jump if < 100 
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PagedGet 



Category: 
Description: 



Inputs: 

Registers: 

Flags: 

Others: 



Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Used for reading data from the archive with the Caching technique. This 
routine will return the next byte and also refill the cache when it is emptied. 

A call to the SetupPagedPtr routine must be done once before using this 
routine to retrieve data from the archive. 



None 
None 

These are initially set by the SetupPagedPtr routine and are updated each 
time a call is made to the PagedGet routine. Applications do not need to 
modify these RAM locations. 

(pagedPN) = current Flash page. 
(pagedGetPtr) = current Flash address. 



ACC = byte read 

None 

None 

ACC 

Crossing ROM page boundaries is handled. See the SetupPagedPtr, 
LoadClndPaged, and Load D El nd Paged routines. Also, see the Accessing 
Archived Variables Without Unarchiving section in Chapter 2. 



LD 


B, PageToGet 




LD 


DE, AddressToGet 




B_CALL 


SetupPagedPtr 


; setup paged get 


B_CALL 


PagedGet 


; ACC = byte from archive 


LD 


E, A 


; E = byte 


B_CALL 


PagedGet 




LD 


D, A 


; DE = 2 bytes read from 



archive 



TI-83 Plus Developer Guide 



12-51 



Third Release January 25, 2002 



System Routines — Memory 



RCIGDB2 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Memory 

Recalls graph database. 

A = tVarGDB 
None 

OP1 = data base name 
(chkDelPtrl) contains data pointer 

None 
None 
None 



Acts exactly as the user controlled RclGDB command: Restores graph mode 
stored in the GDB and replaces all equation variables with those stored in the 
GDB and all range values with those stored in the GDB. 

; Restore GDB2 if it exists: 



GDB2Name : 



B_CALL 


ZeroOPl 


; zero out OP1 


LD 


HL, GDB2Name 


; name -> OP1 


LD 


DE, OP1 




LD 


BC, 03 




LDIR 






B_CALL 


FindSym 


; find & point to symbol. 


RET 


C 


; abort if does not exist 


B_CALL 


RclGDB2 


; restore graph data base 


DB 


GDBOb j, tVarGDB, 


tGDB2 (008h, 061h, OOlh) 
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RcIN 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Memory 

Recalls the contents of variable N if it exists. 



None 
None 
None 



None 
None 

System error if N does not exist. 

OP1 = contents of N if RealObj 
OP1/OP2 = contents of N if CplxObj 

All 



OP1 -OP2 
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RclVarSym 



Category: 
Description: 
Inputs: 

Registers: None 

Flags: 

Others: 
Outputs: 

Registers: None 

Flags: 

Others: 



Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Memory 

Recalls the contents of variable A - Z or THETA. 



None 

OP1 = name of variable to recall 



None 

System error if variable does not exist. 

If a variable other than A - Z or THETA, then nothing is done. 

OP1 = contents of variable if RealObj 
OP1/OP2 = contents of variable if CplxObj 

All 

OP1 -OP2 
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RclX 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Memory 

Recalls the contents of variable X if it exists. 



None 
None 
None 



None 
None 

System error if X does not exist. 

OP1 = contents of X if RealObj 
OP1/OP2 = contents of X if CplxObj 

All 



OP1 -OP2 



TI-83 Plus Developer Guide 



12-55 



Third Release January 25, 2002 



System Routines — Memory 



RclY 

Category: 

Description: 

Inputs: 

Registers: None 
Flags: None 
Others: None 

Outputs: 

Registers: None 



Memory 

Recalls the contents of variable Y if it exists. 



Flags: 
Others: 



Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



None 

System error if Y does not exist. 

OP1 = contents of Y if RealObj 
OP1/OP2 = contents of Y if CplxObj 

All 

OP1 -OP2 
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RedimMat 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 



Example: 



Memory 

Redimensions an existing matrix. 

HL = new dimension of matrix wanted 
None 

OP1 = name of matrix 

None 
None 
None 

All, iMathPtrl, insDelPtr 
OP1, OP3 

If not enough room, then a memory error will occur. 

The space is allocated/deallocated. The pointers are adjusted accordingly. All 
the new elements are set to 0. The old values of the elements that are not 
removed are kept. A Matrix cannot be modified if it is archived. 



skip : 
MatrixA: 



B_CALL 


ZeroOPl 


zero out OPl 


LD 


HL, MatrixA 




LD 


DE, OPl 




LD 


BC, 3 




LDIR 




load matrix name into OPl 


B_CALL 


ChkFindSym 


find matrix variable name 


JR 


C, skip 


if not found, skip over work 


LD 


A, B 




OR 


A 


see if archived 


JR 


NZ, skip 


skip if variable archived 


LD 


HL, 0505h 








redimensionalize matrix to 5x5 


B_CALL 


RedimMat 




RET 






DB 


MatOb j, tVarMat 


, MatA 
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SetupPagedPtr 

Memory 



Category: 
Description: 



Inputs: 

Registers: 



Flags: 
Others: 
Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

Remarks: 
Example: 



Initializes the process of reading data from the archive using the caching 
method. 

The PagedGet routine is used to read data from the archive after this 
initialization routine is called. 



Start address of the first byte of data to be read 
B = ROM page of the first byte 
DE = address of first byte, on the ROM page 
(4000h-7FFFh) 

None 
None 

None 
None 

These outputs are inputs to the PagedGet routine. An application should not 
change these values directly. 

pagedCount = 0 on first call 
pagedPN = current Flash page 
pagedGetPtr = current Flash address 

None 

See the PagedGet routine. Also, see the Accessing Archived Variables 
Without Unarchiving section in Chapter 2. 



LD 


B, PageToGet 




LD 


DE, AddressToGet 




B_CALL 


SetupPagedPtr 


; setup paged get 


B_CALL 


PagedGet 


; ACC = byte from archive 


LD 


E, A 


; E = byte 


B_CALL 


PagedGet 


r 


LD 


D, A 


; DE = 2 bytes read from 



archive 
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SrchVLstDn, SrchVLstUp 



Category: 
Description: 



Memory 

Searches the I/O var list in the backward/forward direction, next lower 
alphabetically, and by type in the following order: 



PROGRAM, ProtPtrg 


05h,06h 


DATABASE 


08h 


PICTURE 


07h 


LIST.CIist 


01h,0Dh 


MATRIX 


02h 


WARS 


03h 


AppVars 


15h 


Group 


17h 


WINDOW 


OBh 


ZSTO 


OCh 


TABLE RANGE 


ODh 


REAL 


OOh 


Cplx 


OCh 


String 


04h 


Apps 


14h 



Inputs: 

Registers: QP1 = last name and type found in variable format 

Flags: inGroup, (IY + groupFlags) should be reset 
inDelete, (IY + ioDelFlag) should be reset 

Others: 
Outputs: 

Registers: hi_ = pointer to symbol table entry if found 
Flags: 



(varClass) should be set to 9 to search through the entire list. 



Others: 

Registers 
destroyed: 

Remarks: 



Example: 



CA = 0 if found 
CA = 1 if did not find anything 

OP1 = var format of next variable if found 

All registers 

This calls FindAlphaUp/FindAlphaDn to find variables within each variable 
type. 
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StMatEl 

Category: 
Description: 

Inputs: 

Registers: 

Flags: 
Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Memory 

Stores an element to a matrix. Convert matrix or element to complex if 
necessary. 



BC = column number 
DE = row number 

None 

OP1 = existing matrix variable name 
FPST = value to store (real or complex) 



None 

graphDraw set if graph reference flag was on. 

OP1 = value originally on FP stack 

FPST was popped, value no longer on FPST 

Value was stored to the matrix 

All 
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StoAns 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

Remarks: 



Memory 

Stores OP1 to Ans variable. 

None 
None 

OP1 [,OP2] = value if real [complex] 

Otherwise OP1 = name of variable that contains the data to store into Ans 



None 
None 

Data stored if possible 

OP1[,OP2] = original contents if real[complex] 
else OP1 = Ans variable name 

FPS, OP1, OP2, OP4 

If input was a parser temporary ($P) variable, it is marked dirty (to be deleted 
by memory management). 

A memory error occurs if there is not enough room to store the value. 

Ans is the same system variable that is found by pressing [2nd] [Ans] on the 

calculator keyboard. 

Use RclAns to recall the contents of Ans. 



Example: 
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StoGDB2 

Category: Memory 

Description: Stores the current graph mode settings and equations into a system graph 
database variable. 

Inputs: 

Registers: None 

Flags: None 

Others: OP1 = graph database name to store to 
Outputs: 

Registers: None 

Flags: None 

Others: GDB created or modified 

Registers All 
destroyed: 

RAM used: (ioData) buffer used to store name temporarily. 

Remarks: This creates the graph database if it did not exist already. If it did exist, it is 
resized to fit the size of the variables to be stored. 

Example: 
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StoN 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Memory 

Stores OP1 to sequence variable n. 



None 
None 

OP1 = a real number, positive integer 



None 
None 

Sets chkDelPtr3 = system table pointer 
Sets chkDelPtrl = data pointer 

All 



OP1, OP2, OP4 

This does not store to variable N. 

This will store to the system variable n used in Sequence graphing. 
To recall, see RclN. 
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StoOther 



Category: 
Description: 



Inputs: 

Registers: 

Flags: 

Others: 



Outputs: 

Registers: 
Flags: 

Others: 



Registers 
destroyed: 



Memory 

General purpose routine that stores data to user created variables that are not 
of type ProgObj, GDBObj, GroupObj, AppObj or PictObj. 

Also, this routine should not be used to store to system variables such as 
Xmin. 



None 
None 

OP1 = name and type of variable to store to. 
(OP1) = data type, followed by the name. 
FPST = data to store if not storing to CplxObj 
FPS1/FPST = data to store if storing to CplxObj 

If the variable storing to is RealObj or CplxObj, then the data storing CANNOT 
be another variable. The FPS must contain the literal data stored. 

If the variable storing to is not RealObj or CplxObj, then the data storing MUST 
be another variable. This variable can either be user created or a temporary 
variable returned by the parser after executing an expression. 

If the variable storing to is already created, then it must reside in RAM and not 
the archive. 



None 

Both the graph and the table can be marked dirty if the variable stored to was 
used in a graph equation. 

Error if the data is not the correct type to be stored to the variable — for 
example, store list data to a matrix. 

Error if the variable storing to is archived. 

Error if not enough memory. 

If no errors: 

If the variable storing to was not created on input, this routine will create it. 

Data stored to the variable. 

OP1/OP2 = data that was stored. 

The data is removed from the FPS. 

All 
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StoOther (continued) 

Remarks: See the StoSysTok routine. See Chapter 2 for Error Handlers and Floating 
Point Stack. 

Example: Store list L1 to list L3. 



LD 


HL, Llname 




B_CALL 


Mov9ToOPl 


; 0P1 = LI name 


B_CALL 


PushRealOl 


; FPST = LI name 


LD 


A, tL3 


; token for L3 


LD 


(0P1+2) , A 


; change 0P1 to L3 name 


B_CALL 


StoOther 


; store LI -> L3 


RET 







Llname : 

DB ListObj,tVarLst,tLl,0 
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StoR 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 



Example: 



Memory 

Stores OP1 [,OP2] -> user variable R. 

None 
None 

OP1 = real value to store 
or 

OP1/OP2 = complex value to store 

None 
None 

Sets chkDelPtr3 = system table pointer 
Sets chkDelPtrl = data pointer 

All 

OP1, OP2, OP4 

Note that there is not a RclR routine, but one can be made by: 



B_CALL 
B_CALL 

; This sets R to 1 : 
B_CALL 
B_CALL 
RET 



RName ; set OP1 to R name 

RclVarSym ; do recall 



OPISetl 
StoR 



; INIT R = 1 
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StoSysTok 



Category: Memory 

Description: Stores a value in OP1 to system variable specified by token number in the 
accumulator. 

Inputs: 

Registers: A = system variable token number 
OP1 = real number to save 

Flags: None 

Others: None 

Outputs: 

Registers: OP1 



contents of system variable 



Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



None 
None 



_CALL 
_CALL 



LD 



_CALL 



OPlSet3 
InvOPIS 

A, XMINt 
StoSysTok 



Store -3 into Xmin 

register OP1 = floating point 3 

negate FP number in OP1, 

OP1 = -3 

ACC = Xmin variable token value 
store 0P1 to Xmin, 
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StoT 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 



Example: 



Memory 

Stores OP1 [,OP2] to user variable T. 

None 
None 

OP1 = real value to store 
or 

OP1/OP2 = complex value to store 

None 
None 

Sets chkDelPtr3 = system table pointer 
Sets chkDelPtrl = data pointer 

All 

OP1, OP2, OP4 

Note that there is not a RcIT routine, but one can be made by: 



_CALL 
_CALL 



B_CALL 
RET 



TName 
RclVarSym 



StoT 



set OP1 to T name 
do recall 



This sets T to 0. 

OPISetO 

INIT T = 0 



_CALL 
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StoTheta 



Category: Memory 

Description: Stores OP1 [,OP2] to user variable Theta. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = real value to store 
or 

OP1/OP2 = complex value to store 

Outputs: 

Registers: None 
Flags: None 

Others: Sets chkDelPtr3 = system table pointer 



Registers 
destroyed: 

RAM used: 
Remarks: 



Example: 



Sets chkDelPtrl = data pointer 
All 

OP1, OP2, OP4 

Note that there is not a RclTheta routine, but one can be made by: 



B_CALL 
B_CALL 



ThetaName 
RclVarSym 



This sets Theta to 2... 

B_CALL OP 1 Set 2 

B_CALL StoTheta 
RET 



set OP1 to Theta name 
do recall 



INIT Theta 
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StoX 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Memory 

Stores OP1 [,OP2] to user variable X. 



None 
None 

OP1 = real value to store 
or 

OP1/OP2 = complex value to store 



None 
None 

Sets chkDelPtr3 = system table pointer 
Sets chkDelPtrl = data pointer 

All 

OP1, OP2, OP4 

See RclX to recall contents of X. 

r 

; This sets X to 2 : 

B_CALL OP 1 Set 2 

B_CALL StoX ; INIT X = 2 

RET 
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StoY 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Memory 

Stores OP1 [,OP2] to user variable Y. 



None 
None 

OP1 = real value to store 
or 

OP1/OP2 = complex value to store 



None 
None 

Sets chkDelPtr3 = system table pointer 
Sets chkDelPtrl = data pointer 

All 

OP1, OP2, OP4 

See RclY to recall contents of Y. 

r 

; This sets Y to 2 : 

B_CALL OPlSet2 

B_CALL StoY ; INIT Y = 2 

RET 
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13 



System Routines 
Parser 



BinOPExec |13-1 

FiveExec |1 3-3 

FourExec 13-5 

Parselnp n 3-7 

RclSysTok |1 3-9 

ThreeExec h 3-1 0 

UnOPExec fcP\2 
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BinOPExec 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Parser 

Executes functions that have two arguments as inputs. 

ACC = function to execute (see table below) 
None 

OP1 = second argument 

FPST = first argument (Floating Point Stack Top), see example 

None 
None 

OP1 = result 
All 

Checks for valid argument types are done. 
The values pushed onto the FPS are removed. 

This entry point should only be used if direct access to a particular function is 
not available. 

It can also be used in cases of mixed argument types. Like the example below 
where a real is added to a list. 

Valid arguments can be obtained from the TI-83 Plus Guidebook. 

(continued) 
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BinOPExec (continued) 

Example: .5 + li 





LD 


HL, Point5 










RST 


rMov9ToOPl 


; OP1 = 


.5 






B_CALL 


PushOPl 


; OP1 - 


> FPST, or 


OP1/OP2 is 








; complex number 




} 


LD 


HL, Llname 










RST 


rMov9ToOPl 


; OP1 = 


LI name 






LD 


A, OPAdd 


; function is addition 




B_CALL 


BinOPExec 


; OP1 = 


result of 


.5 + LI 


Llname : 


DB 


RListob j, tVarLst, tLl, 0, 0 




BinOPExec 


equates and functions 








Equate 


Function 


Equate 


Function 


Equate 


Function 


OPBal 


bal ( 


OPSum 


sum ( 


OPProd 


prod ( 


OPBinCdf 


binomcdf ( 


OPBinPdf 


binompdf ( 


OPIrr 


irr ( 


OPFinNom 


>Nom ( 


OPFinEf f 


>Ef f 


OPFinDbd 


dbd ( 


OPRandNrm 


randNorm ( 


OPstDev 


stdDev ( 


OPVariance 


variance ( 


OPPrn 


iPrn ( 


OPIntr 


ilnt ( 


OPRandBin 


randBin ( 


OPNormalPdf normalpdf ( 


OPINormal 


invNorm ( 


OPNormal 


normalcdf ( 


OPPoiPdf 


poissonpdf ( 


OPPoiCdf 


poissoncdf ( 


OPGeoCdf 


geometcdf ( 


OPGeOPdf 


geometpdf ( 


OPChiPdf 


xypdf ( 


OPTpdf 


tpdf ( 


OPAdd 


+ 


OPSub 




OPMult 


■k 


OPDiv 


/ 


OPPower 




OPXroot 


xuy 


OPEq 




OPRound2 


round ( 


OPConst 


Fill ( 


OPAug 


augment ( 


OPMax 


max ( 


OPMin 


min ( 


OPLcm 


1cm ( 


OPGcd 


gcd ( 


tEvalF 


u (beg, end 


tMedian 


median ( 


tMean 


mean ( 


OPRandlnt 


randlnt ( 


OPAnd 


and 


OPOr 


or 


OPXor 


xor 


OPNcr 


nCr 


OPNpr 


nPr 


OPLt 


< 


OPLe 


<= 


OPGt 


> 


OPGe 


>= 


OPRandl 


randM ( 


OPInstr 


inString ( 


OPPxtst 


Pxl-Test ( 


OPRtOPr 


R>Pr ( 


OPRtOPo 


R>P8 ( 


OPPtorx 


P>Rx ( 


OPPtoRy 


P>Ry ( 











Note: For tEvalF there are really three inputs but execution still goes through the entry 

point for two arguments. The Equation name needs to be pushed onto the FPS first, 
then the second argument and the third in OP1 . This is only valid in Sequential graph 
mode. 



The second argument is the start value. 
The third argument is the end value. 
A list of results is returned. 
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FiveExec 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 



Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Parser 

Executes functions that have five arguments as input. 

ACC = function to execute (see table below) 
None 

OP1 = fifth argument 

FPST = fourth argument (pushed onto FPS fourth) 
FPS1 = third argument (pushed onto FPS third) 
FPS2 = second argument (pushed onto FPS second) 
FPS3 = first argument (pushed onto FPS first) 

None 
None 

OP1 = result 
All 

Checks for valid argument types are done. 
The values pushed onto the FPS are removed. 

This entry point should only be used if direct access to a particular function is 
not available. 

Valid arguments can be gotten from the 77-83 Plus Guidebook. 

(continued) 
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FiveExec (continued) 



Example: 



YIName : 
Point5 : 



LD 
RST 

B_CALL 
B_CALL 
B_CALL 
B_CALL 
B_CALL 

B_CALL 
B_CALL 

LD 

RST 

LD 

B_CALL 

DB 

DB 



HL, Ylname 

rMov9ToOPl 

PushOPl 

XName 

PushOPl 

OPlSet2 

PushOPl 

OPlSet4 
PushOPl 

HL, point5 
rMov9ToOPl 
A,OPFmin ] 
FiveExec 



fin(Yl, X, 2, 4, .5); 



OP1 = Yl name 
save to FPST; 
OP1 = X var name 
push onto FPST, Yl 
OP1 = 2 

push onto FPST, Yl 
X -> FPS1; 
OP1 = 4 

->FPST, Y1->FPS3, 
2->FPSl, 4->FPST; 



-> FPS1; 
-> FPS2, 

X->FPS2, 



OP1 = .5; 
function is fMin ( 
OP1 = result 



EquOb j, tVarEqu, tYl, 0, 0 
0, 80h, 50h, 0,0,0,0,0,0 



FiveExec equates and functions 
Equate Function Equate 

OPQuad 



OPSeq 
OPFmax 



seq ( 
f Max ( 



Function Equate Function 

f nlnt ( OPFmin fmin ( 
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FourExec 

Category: Parser 

Description: Executes functions that have four arguments as input. 
Inputs: 

Registers: ACC = function to execute (see table below) 
Flags: None 

Others: OP1 = fourth argument 

FPST = third argument (pushed onto FPS third) 
FPS1 = second argument (pushed onto FPS second) 
FPS2 = first argument (pushed onto FPS first) 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = result 

Registers All 
destroyed: 

Remarks: Checks for valid argument types are done. 

The values pushed onto the FPS are removed. 

This entry point should only be used if direct access to a particular function is 
not available. 

Valid arguments can be obtained from the TI-83 Plus Guidebook. 

(continued) 
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FourExec (continued) 



Example: 



YIName : 
Point5 : 



LD 
RST 

B_CALL 
B_CALL 
B_CALL 
B_CALL 
B_CALL 

LD 

RST 

LD 

B_CALL 

DB 

DB 



HL, YIName 
rMov9ToOPl 
PushOPl 
XName 
PushOPl 
0PlSet2 
PushOPl 

HL, point5 
rMov9ToOPl 
A, OPDeriv81 
FourExec 
EquOb j, tVarEqu, tYl, 0, 0 
0, 80h, 50h, 0,0,0,0,0,0 



nDeriv (Yl, X, 2, .5) ; 

OP1 = Yl name 
save to FPST; 
OP1 = X var name 
push onto FPST, Yl -> FPS1; 
OP1 = 2 

push onto FPST, Yl -> FPS2, 
X -> FPS1; 

OP1 = .5; 

function is nDeriv 
OP1 = result 



FourExec equates and functions 

Equate Function Equate Function Equate Function 

OPNpv npv ( OPNormal normalcdf ( OPMltRadd *row+ ( 

OPSeq seq( OPQuad fnlnt ( OPDeriv81 nDeriv ( 

OPSolve solve ( OPFmin fMin ( OPFmax f Max ( 

OPDf Fcdf ( 
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Parselnp 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 



Registers 
destroyed: 

Remarks: 



Parser 

Executes an equation or program stored in a variable. 



None 
None 

OP1 = name of equation or program to execute 



None 
None 

If executed an equation, then OP1 and Ans contain the result. 
If executed a program, then no result is returned. 

Errors will be generated during parsing — to avoid them from being displayed, 
install an error handler before parsing. 

All 



See the Parsing Function, Temporary Variables section in Chapter 2 for further 
information. 

(continued) 
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Parselnp (continued) 



Example: 



Parse the graph equation y1 and store the answer in Y. Install an error handler 
around the parsing and the storing to catch any errors. 
RET CA = 0 if OK, else RET CA = 1 . 



LD 

RST 



HL, ylName 

rMov9ToOPl ; OP1 = yl name 



; if an error while parsing go to this label 



AppOnErr ErrorHan 



; error handler installed, 
; (macro) 



B_CALL Parselnp 
returns if no error 



; execute the equation 



B_CALL CkOPlReal ; check if RealObj 

JR Z,storit 



AppOf fErr 



; jump if it is real 
; remove the error handler 



come here if any error was detected 

error handler is removed when the error occurred 



ErrorHan : 



_CALL 



SCF 
RET 



CleanAll ; clean any temp vars created by 

; parser 

; CA = 1 signals failure 



storit : 



_CALL 



StoY 



; store to Y, RET if no error, 
; else ErrorHan 



AppOf fErr 
B_CALL 



CleanAll 



; remove error handler 

; clean any temp vars created by 
; parser 



CP 
RET 



; CA = 0 for no error 



ylName : 



D 3 



EquOb j, tVarEqu, tYl, 0, 0 
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RclSysTok 

Category: Parser 

Description: Recalls a value in system variable specified by token number in the 
accumulator to OP1 . 

Inputs: 

Registers: A = system variable token number 

Flags: None 

Others: None 
Outputs: 

Registers: OP1 = contents of system variable 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: ld a, xMiNt 

B_CALL RclSysTok ; OP1 = contents of Xmin 
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ThreeExec 

Category: Parser 

Description: Executes functions that have three arguments as input. 
Inputs: 

Registers: ACC = function to execute (see table below) 

Flags: None 

Others: OP1 = third argument 

FPST = second argument (pushed onto FPS second) 
FPS1 = first argument (pushed onto FPS first) 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = result 

Registers All 
destroyed: 

Remarks: Checks for valid argument types are done. 

The values pushed onto the FPS are removed. 

This entry point should only be used if direct access to a particular function is 
not available. 

Valid arguments can be obtained from the TI-83 Plus Guidebook. 

(continued) 
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ThreeExec (continued) 

Example: 



LD 
RST 

B_CALL 
B_CALL 
B CALL 



CALL 



LD 



CALL 



HL, MatAName 
rMov9ToOPl 
PushOPl 
OPISetl 
PushOPl 



row + ( [A] , 1, 2) 



MatAName : 



03 



0P1 = [A] name 
save to FPST; 
0P1 = 1 

push onto FPST, mat name 
moves to FPS1; 
0PlSet2 ; 0P1 = 2 ; 

A, OPRAdd ; function is row + 

ThreeExec ; 0P1 = result, a temp Matrix 

variable 
MatOb j, tVarMat, tMatA, 0, 0 



ThreeExec 


equates and 


functions 








Equate 


Function 


Equate 


Function 


Equate 


Function 


OPPrn 


iPrn ( 


OPIntr 


ilnt ( 


OPBinpdf 


binompdf ( 


OPBincdf 


binomcdf ( 


OPIrr 


irr ( 


OPNpv 


npv ( 


OPSum 


sum ( 


OPProd 


prod ( 


OPNormalPdf 


normalpdf ( 


OPRandNrm 


randNorm ( 


OPRandBin 


randBin ( 


OPRandlnt 


randlnt ( 


OPINormal 


invNorm ( 


OPInstr 


inString ( 


OPNormal 


normalcdf ( 


OPDt 


tcdf ( 


OPFpdf 


Fpdf ( 


Opchi 


x 2 cdf ( 


OPSubstr 


sub ( 


OPDeriv81 


nDeriv ( 


tEvalF 


Eval ( 


OPRadd 


row+ ( 


OPRswap 


rowSwap ( 


OPRmlt 


row* ( 


OPMltRadd 


*row+ ( 


OPSolve 


solve ( 







Note: For tEvalF there are really four inputs but execution still goes through the entry point 
for three arguments. The Equation name needs to be pushed onto the FPS first, then 
the second argument and then third, and then the fourth in OP1 . This is only valid in 
Sequential graph mode. 



The second argument is the start value. 
The third argument is the end value. 
The fourth argument is the step size. 

A list of results is returned. 
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UnOPExec 

Category: Parser 

Description: Executes functions that have one argument as the input. 
Inputs: 

Registers: ACC = function to execute (see table below) 

Flags: None 

Others: OP1 = argument 

Outputs: 

Registers: None 

Flags: None 

Others: OP1 = result 

Registers All 
destroyed: 

Remarks: This entry point should only be used if direct access to a particular function is 
not available. 

It is also useful to use this entry point when arguments are not simply real 
numbers. See example below. 

Valid arguments can be obtained from the TI-83 Plus Guidebook. 

(continued) 
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UnOPExec (continued) 

Example: 

LD 

RST 

LD 

B_CALL 
Llname: DB 



UnOPExec equates and functions 



Equate 


Function 


Equate 


Function 


Equate 


Function 


OPLog 


log( 


OPTenX 


10 A X ( 


OPLn 


ln( 


OPEtoX 


e A X ( 


OPNot 


not ( 


OPSin 


sin ( 


OPAsin 


sin-1 ( 


OPCos 


cos ( 


Pacos 


cos-1 ( 


OPTan 


tan ( 


OPAtan 


tan-1 ( 


OPSinh 


sinh ( 


OPAsinh 


sinh-1 ( 


OPCosh 


cosh ( 


OPAcosh 


cosh-1 ( 


OPTanh 


tanh ( 


OPAtanh 


tanh-1 ( 


OP In verse 


recipricol 


OPDet 


det ( 


OPSqroot 


Sqrt 


OPSquare 


A 2 


Opnegate 


(-) 


OPIpart 


iPart ( 


OPFpart 


fPart ( 


OPIntgr 


int ( 


tEvalF 


y# (value 


OPConj 


conj ( 


OPFact 


i 


OPAbs 


abs ( 


OPIdent 


identity ( 


OPTranspose 


mat transpose 


OPSum 


sum ( 


OPProd 


prod ( 


OPMin 


min ( 


OPMax 


max ( 


OPTof rac 


>Frac 


OPReal 


real ( 


OPImag 


Imag ( 


OPAngle 


angle ( 


OPExpr 


expr ( 


OPRound2 


round ( 


OPLength 


length ( 


OPCube 


A 3 


OPCbrt 


V 


OPDim 


dim ( 


OPRad 


A r 


OPDeg 




tMean 


mean ( 


tMedian 


median ( 


OPRef 


ref ( 


OPRref 


rref ( 


OPCumSum 


curaSura ( 


OPNormalPdf 


normalPdf ( 


OPInormal 


invNorm ( 


OPDeltalst 


-List ( 


OPBal 


bal ( 


OPStdev 


stdDev ( 


OPVariance 


variance ( 


OPRand 


rand 







Note: For tEvalF there are really two inputs but execution still goes through the entry point 
for one argument. The Equation name needs to be pushed onto the FPS first, and 
the second argument in OP1 . 



This is valid in all graph modes. 

The second argument is the value to evaluate at. 



; sin (LI) 

HL, Llname 

rMov9ToOPl ; OP1 = LI name; 

A, OPSin ; function is addition 

UnOPExec ; OP1 = result of sin (LI) a 

; temp list variable 
RListObj, tVarLst, tLl, 0, 0 
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14 



System Routines 
Screen 



ForceFullScreen 14-1 
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ForceFullScreen 

Category: Screen 

Description: Switches the TI-83 Plus to Full Screen mode if currently In Horizontal or 
Vertical split mode. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers All 
destroyed: 

Remarks: Graph is dirtied if mode switched. 
Example: 
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15 



System Routines 
Statistics 



DelRes 15-1 



OneVar 15-2 



Rcl StatVar 15-3 



TwoVarSet 15-4 
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DelRes 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 
Example: 



Statistics 

Invalidates the statistic results. 



None 
None 
None 



None 
None 

Statistic result variables marked as undefined. 
RegEq variable is deleted. 

All 



Note that this routine does not set the graph Draw flag even if the stat result 
variable is used in a graph equation. This is a known problem. 

B_CALL DelRes ; invalidate stat results 
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OneVar 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 



Statistics 

Executes one-variable statistics. 



ACC 



Others: 



Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



number of arguments input 
No_Del_Stat, (IY + morejlags) = 1 if: 

Stat results that are not associated with one-variable stats are not to be 

deleted when this routine executes. 

Also no Min's, Max's, or Quartiles will be computed. 

Otherwise: previous statistic results are cleared. 

If ACC = 1 then OP1 = data list name. 

If ACC = 2 then OP1 = frequency list name. 

FPST = data list name. 
Dimensions must match if two arguments. 



None 

statANSDISP, (lY+statFlags) = 1 

If no errors then one-variable stat output variables are updated. 
All 

If the input lists have a formula associated with them this routine will not 
execute it and update the list values. This must be done by the calling 
routine. 

See Find_Parse_Formula. 

Run one-variable stats on data list L1 and freq. list L2. 



Llname : 
L2name : 



LD 


HL, Llname 




RST 


rMov9ToOPl 


; OP1 = LI 


RST 


rPushRealOl 


; data ->FPST 


LD 


HL, L2name 




RST 


rMov9ToOPl 


; OP1 = L2 


B_CALL 


OneVar 


; execute 1-variable 


RET 






DB 


Li st Ob j , tVarLst, 


til, 0, 0 


DB 


Li st Ob j , tVarLst, 


tL2, 0, 0 
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Rcl StatVar 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Statistics 

Recalls a statistic result variable to OP1 . 



ACC = stat variable to recall token value. These are listed in the TI83plus.inc 
file. 

None 

None 



None 
None 

OP1 = stat variable value, floating-point number 
All but the ACC. 



The statistic variables are validated by running a regression or one/two 
variable statistic commands. 

This routine does not check that the statistic variables are valid. Recalling 
one when not valid may result in random values. 

Recall statistic result variable X mean, assume statistic have been 
computed. 



LD 

B CALL 



A, tXMean 
Rol StatVar 



token value for XMean 
recall contents to OP1 
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TwoVarSet 

Category: Statistics 

Description: Executes two-variable statistics and regressions. 
Inputs: 

Registers: ACC = number of arguments input. Must be at least 2. 



- 0 = 


LinReg (a+bx) 


- 1 = 


ExpReg 


- 2 = 


LnReg 


- 3 = 


PwrReg 


- 4 = 


LinReg (ax+b) 


- 5 = 


QuadReg 


- 6 = 


CubicReg 


- 7 = 


QuartReg 


- 8 = 


Med-Med 


- 9 = 


2-Var Stats 



19h = LinRegTTest 
1Ah = Logistic 
1Bh = In use for ANOVA 
1Ch = SinReg 



Flags: No_Del_Stat, (IY + morejlags) = 1 if: 

Stat results that are not associated with one-variable stats are not to be 

deleted when this routine executes. 

Also no Min's, Max's, or Quartiles will be computed. 

Otherwise: previous statistic results are cleared. 

Others: If ACC = 2 then OP1 = Y - data list name. 

FPST = X - data list name. 

If ACC = 3 then OP1 = frequency list name. 

FPST = Y - data list name. 
FPS1 =X -data list name. 

If ACC = 4 then OP1 = Name of equation to store RegEq to. 

FPST = frequency list name. 

FPS1 = Y-data list name. 

FPS2 = X - data list name 
List dimensions must match. 
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Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



None 

statANSDISP, (lY+statFlags) 



1 



If no errors then stat output variables are updated. Arguments are removed 
from Floating Point Stack. 

All 

This B CALL is not available on OS version 1 .1 2 or below. The application 
should check the OS version before calling this routine. See GetBaseVer. 

If the input lists have a formula associated with them this routine will not 
execute it and update the list values. This must be done by the calling 
routine. 

See Find_Parse_Formula. 

Calculate LinReg(ax+b) on x-list L1 and y-list L2, and store the results in Y1 . 





LD 


HL, Llname 








RST 


rMov9ToOPl 




; OP1 = LI 




RST 


rPushRealOl 




; data ->FPST 


t 


LD 


HL, L2name 








RST 


rMov9ToOPl 




; OP1 = L2 




RST 


RPushRealOl 




; FPS1 = LI; FPST = 


f 


LD 


HL, Ylname 








RST 


rMov9ToOPl 




; OP1 = Yl 




LD 


A, 3 




; 3 arguments 




LD 


B, 4 




; calc. LinReg(ax+b) 




B_CALL 


TwoVarSet 




; execute stats 


t 


RES 


statANSDISP, 


(IY+statFlags) 


; don't show results 




RET 








Llname : 


DB 


ListObj,tVarLst,tLl, 0, 0 




L2name : 


DB 


ListObj,tVarLst,tL2, 0, 0 




Ylname : 


DB 


EquObj, tVarEqu, tyl, 0, 0 





L2 
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System Routines 
Utility 



Applnit |16-1 

AnsName |1 6-2 

Chk_Batt_Low |1 6-3 

ConvDimOO |1 6-4 

CpHLDE |16^5" 

DisableApd |1 6-6 

EnableApd |1 6-7 

EOPINotReal [fiTf 

Equ_or_NewEqu |1 6-9 

GetBaseVer |1 61 0 

GetSyslnfo [16-11 

GetTokLen h 6-1 3 

Get_Tok_Strng h 6-1 4 

lsA2ByteTok [16-15 

JForceCmdNoChar |1 6-16 

JForceGraphKey |1 6-17 

JForceGraphNoKey h 6-1 8 

MemClear |1 6-1 9 

MemSet |1 6-20 

Mov7B, Mov8B, Mov9B, MovlOB, Mov18B |16-21 

Mov90P10P2 |TF22~ 

Mov90P2Cp |16-23 

Mov9ToOP1 \\(P2A 

Mov9ToOP2 |16-25 

MovFrOPI |16-26 

NZIf83Plus ITFl^ 

OP1 ExOP2, OP1 ExOP3, OP1 ExOP4, OP1 ExOP5, OP1 ExOP6, 

OP2ExOP4, OP2ExOP5, OP2ExOP6, OP5ExOP6 116-28 

OP1ToOP2, OP1ToOP3, OP1ToOP4, OP1ToOP5, OP1ToOP6, 
OP2ToOP1, OP2ToOP3, OP2ToOP4, OP2ToOP5, OP2ToOP6, 
OP3ToOP1, OP3ToOP2, OP3ToOP4, OP3ToOP5, OP4ToOP1, 
OP4ToOP2, OP4ToOP3, OP4ToOP5, OP4ToOP6, OP5ToOP1 , 
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OP5ToOP2, OP5ToOP3, OP5ToOP4, OP5ToOP6, OP6T0OPI , 

OP6ToOP2, OP6ToOP5 \^29 



PosNoOInt 16-30 



PutAway 116-31 



RclAns 1 6-33 



ReloadAppEntryVecs [1 6-34 



SetExSpeed p 6-35 



SetXXOPI 16-37 



SetXXOP2 1 6-38 



SetXXXXOP2 1 6-39 



StoRand 16-40 



StrCopy 16-41 



StrLength |1 6-42 
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Applnit 

Category: 
Description: 



Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Utility 

Sets system monitor vectors. 

This routine is used by advanced applications to override the system monitor 
vector table. This routine should only be used by applications, not ASM 
programs. 

HL points to monitor vector table. 

None 

None 

None 
None 

OP1 contains the variable name Ans. 
All 

A common use of Applnit is to override the system's putaway vector. This 
allows the application to save its state or clean up any flags before shutting 
down if the user presses 2 nd + OFF or silent link activity is detected during a 
system BCALL GetKey. 



Monitor vector table format: 



VecTab : 



DW 
DW 
DW 
DW 
DW 
DW 
DB 



CXMainPtr 

CXPPutAwayPtr 

CXPutAwayPtr 

CXRedispPtr 

CXErrorEPPtr 

CXSizeWindPtr 

AppFlagsByte 



Example: 



The application must set all of these pointers to a label somewhere in the 
application. If a vector is not used, it must point to a RET statement. 

If an application uses Applnit to change the system monitor vectors, it must 
perform a B CALL ReloadAppEntryVecs before exiting and also in the 
application's putaway routine. 

See also ReloadAppEntryVecs. 

See Chapter 2: "Entering and Exiting an Application Properly" for example 
putaway code. 
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AnsName 

Category: Utility 

Description: Loads OP1 with the variable name Ans. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 contains the variable name Ans. 

Registers All 
destroyed: 

Remarks: 

Example: B_CALL AnsName ; load OP1 with Ans variable 
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Chk Batt Low 



Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Utility 

Check for low battery. Return Z = 1 if battery is low. 

None 
None 
None 



Z = 1 if battery is low. 

Z = 0 if battery is not low. 

None 

None 

All 

An application should check the battery condition before attempting to 
archive a variable. There is a risk of corrupting the archive if the attempt 
fails due to low batteries. 

Archive variable whose name is in OP1 if batteries are not low: 



errorHand : 



B_CALL 
RET 

B_CALL 
RET 
LD 
OR 

RET 

AppOnErr 
B_CALL 
AppOf fErr 
RET 



Chk_Batt_Low 
Z 

ChkFindSym 

C 

A, B 

A 

NZ 

errorHand 
Arc Unarc 



; check battery level 
; ret if low batteries 



return if variable does not exist 
get archived status 
if non zero then it is archived 
already 

ret if archived 
install error handler 

; archives the variable 

; remove error handler 
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ConvDimOO 



Category: 
Description: 

Inputs: 



Outputs: 



Utility 

Converts floating-point number in OP1 to a two-byte value and compares 
that value with an input two-byte value. 

Registers: 
HL = two-byte test value 
Flags: 

None 

Others: 

OP1 = floating-point value, must be a positive integer < 10,000 



Registers: If no error on the input: 

A = LSB hex value of OP1 
DE = entire hex value of OP1 



Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



None 
None 
All 



Test OP1 = positive integer < or = 400: 



LD 

B CALL 



HL, 400d 
ConvDimOO 



test value 
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CpHLDE 



Category: Utility 

Description: Non destructives compare of registers HL and DE. 
Inputs: 

Registers: HL = two-byte value 
DE = two-byte value 

Flags: None 

Others: None 

Outputs: 

Registers: HL, DE intact 

Flags: CA = 1 if DE > HL 

Z = 1 if HL = DE 
CA = 0 if HL > DE 

Others: None 

Registers None 
destroyed: 

Remarks: 

Example: b_call c p hlde 
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DisableApd 



Category: Utility 

Description: Turns off Auto Power Down feature. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: apdAble, (IY + apdFlags) is reset 

Registers None 
destroyed: 

Remarks: Applications should re-enable APD before exiting. See EnableApd. 
Example: 
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EnableApd 



Category: Utility 

Description: Turns on Auto Power Down. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers None 
destroyed: 

Remarks: The TI-83 Plus will now power down if not used for approximately 
four minutes. 

Example: 
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EOP1 NotReal 

Category: Utility 

Description: Tests object in OP1 to be a real data type. If it is not, then jump to the 
system error DATA TYPE. 

Inputs: 

Registers: None 

Flags: None 

Others: (OP1 ) = objects data type byte 
Outputs: 

Registers: None 

Flags: None 

Others: Error if not OP1 — it does not have the data type RealObj. 

Registers A 
destroyed: 

Remarks: 

Example: 
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Equ_or_NewEqu 



Category: Utility 

Description: Sees if A = EquObj or NewEquObj type. 
Inputs: 

Registers: A = type, can have flags set 

Flags: None 

Others: None 

Outputs: 

Registers: A = type with flags reset 

Flags: Z set if A = EquObj or NewEquObj type 

Others: None 

Registers None 
destroyed: 

Remarks: 

Example: ; see if ACC is EquObj or NewEquObj 

Equ_or_NewEqu : : 

AND lFh 

CP EquObj 

RET Z 

CP NewEquObj 

RET 
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GetBaseVer 

Category: Utility 

Description: Returns current operating system version number. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: A = major version number 
B = minor version number 

Flags: None 

Others: None 

Registers A, B 
destroyed: 

Remarks: 

Example: For Operating system 1 .00: A = 1 , B = 0. 
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GetSyslnfo 

Utility 



Category: 

Description: 

Inputs: 

Registers: HL = 
Flags: None 
Others: None 

Outputs: 

Registers: None 



Return nine bytes of system information, including current speed. 
RAM location to save system information. 



Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 



None 

(HL)...(HL+8) contain system information. 
All 



This BCALL is not available on TI-83 Plus version 1.12 and earlier. The 
calling routine needs to check the software version before performing this 
B CALL. See GetBaseVer. 

This routine returns nine bytes of data representing various aspects of 
system operation: 



Btye 




00 


Boot code revision # (Major) 


01 


Boot code revision # (Minor) 


02 


Hardware revision # (00 is TI-83 Plus, NZ if not) 


03 


Lsn = Current Speed 


03 


Bit 4 reset if TI-83 Plus; set if TI-83 Plus Silver Edition 


04 


Device code default 


05 


Reserved 


06 


Reserved 


07 


Reserved 


08 


Reserved 


(continued) 



Example: 



Determine if running fast or slow. 



TI-83 Plus Developer Guide 



16-11 



Third Release January 25, 2002 



System Routines - Utility 



B_CALL 

CP 

JR 

; cp 

JR 
LD 
CP 
JR 

MustBeSlow: 

XOR 
JR 

Abovell2 : 

LD 

B_CALL 

LD 

AND 

Done : 
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GetBaseVer ; OS version in A, B 

2 ; check major version 

NC, abovell2 ; if 2.x, then > 1.12 

1 

NZ, MustBeSlow ; if 0.x, then < 1.12 

A, B ; major version = 1 

13 ; check minor version 

NC, abovell2 ; C if minor version < 13 

A ; set Z to show slow 
Done 



HL, OP1 

GetSysInfo 
A, OP1+3 
OFh 



later than 1 . 12 



System Routines - Utility 



GetTokLen 

Category: Utility 

Description: Return the number of characters in a token's string. 
Inputs: 

Registers: DE = pointer to either a one or two byte token 

Flags: None 

Others: None 
Outputs: 

Registers: A = number of characters in the token's string 
HL = address of string in Flash ROM. 

Flags: None 

Others: None 

Registers All 
destroyed: 

RAM used: 

Remarks: 

Example: Find the number of characters in the 'Sin(' token string. 

LD DE,tSin ; Sin ( token 

B_CALL GetTokLen ; ACC = 4, the length of 'SinC 
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Get_Tok_ 

Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

RAM used: 

Remarks: 

Example: 



Strng 

Utility 

Copy a token's string to OP3 and return the number of characters in the 
string. 



HL = pointer to either a one or two byte token 

None 

None 



A = number of characters in the token's string 

BC = also contains the number of characters in the token's string 

HL = address of OP3, location the string was copied to 

None 

String copied to RAM, starting at OP3 
All 



OP3 - OP3 + (length of string) 



Find the number of characters in the 'Sin(' token string. 

LD A, tSin ; Sin( token 

LD (OPl),A 

LD HL,OPl ; pointer to token 

B_CALL Get_Tok_Strng ; 
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lsA2ByteTok 



Category: Utility 

Description: Determines if token in A is a one or two byte token. 
Inputs: 

Registers: A = First byte of token 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: Z = 1 if A is the first byte of a two byte token 

Z = 0 if A is not a two byte token. 

Others: None 

Registers None 
destroyed: 

Remarks: The two byte token identifiers are: t2ByteTok, tVarStrng, tGFormat, tVarSys, 
tVarOut, tVarGBD, tVarPict, tVarEqu, tVarLst, and tVarMat. 

Example: 
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JForceCmdNoChar 



Category: Utility 

Description: Exits the Application and returns to the home screen. 

This should not be used to exit an application if the TI-83 Plus system 
monitor is closing the application due to link activity or turning off. 

This routine will be the used in most applications to Close the application 
and return control to the TI-83 Plus system. 

Before an application jumps to this entry point it must make certain the 
systems monitor vectors are set to the Application loader context. 

See Entering and Exiting an Application Properly. 



Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 



None 
None 

Monitor vectors should be set to the Application loader. 



None 
None 

The home screen is given control. 
All 

Only use a B JUMP with this entry point. 

This can be used by an application anytime — the return stack does not 
need to be at any certain level. This routine will set the stack level back to a 
safe level. 

ASM PROGRAMS SHOULD NOT USE THIS ROUTINE TO EXIT BACK TO 
THE SYSTEM. 

Example: Set the monitor vectors to the Application loader and exit the application and 
return control to the home screen. 



Exit_App : 



B_CALL 



_JUMP 



ReloadAppEntryVecs 



JForceCmdNoChar 



load the monitor vectors 
to App loader 

exit the app and 
initiate home screen 
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JForceGraphKey 



Category: Utility 

Description: Exits the Application and returns to the graph screen with a key to be 
executed in the graph screen. 

This should not be used to exit an application if the TI-83 Plus system 
monitor is closing the application due to link activity or turning off. 

This routine will be the used in most applications to Close the application 
and return control to the TI-83 Plus system. 

Before an application jumps to this entry point it must make certain the 
systems monitor vectors are set to the Application loader context. 

See Entering and Exiting an Application Properly. 



Inputs: 

Registers: ACC = 
Flags: None 
Others: None 

Outputs: 

Registers: 
Flags: 
Others: 



key to execute in the graph screen 



Registers 
destroyed: 

Remarks: 



None 
None 
None 
All 



Example: 



Only use a B JUMP with this entry point. 

This can be use by an application anytime — the return stack does not need 
to be at any certain level. This routine will set the stack level back to a safe 
level. 

ASM PROGRAMS SHOULD NOT USE THIS ROUTINE TO EXIT BACK TO 
THE SYSTEM. 

Set the monitor vectors to the Application loader and exit the application and 
enter trace mode. 



Exit_App : 



B_CALL ReloadAppEntryVecs ; load the monitor vectors 

; to App loader 



LD A, kTrace 

B_JUMP JForceGraphKey ; exit the app enter trace 

; mode 
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JForceGraphNoKey 



Category: Utility 

Description: Exits the Application and returns to the graph screen. 

This should not be used to exit an application if the TI-83 Plus system 
monitor is closing the application due to link activity or turning off. 

This routine will be the used in most applications to close the application and 
return control to the TI-83 Plus system. 

Before an application jumps to this entry point it must make certain the 
systems monitor vectors are set to the Application loader context. 

See Entering and Exiting an Application Properly. 

Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers All 
destroyed: 

Remarks: Only use a B JUMP with this entry point. 

This can be use by an application anytime — the return stack does not need 
to be at any certain level. This routine will set the stack level back to a safe 
level. 

ASM PROGRAMS SHOULD NOT USE THIS ROUTINE TO EXIT BACK TO 
THE SYSTEM. 

Example: Set the monitor vectors to the Application loader and exit the application and 
give control to the graph context. 



Exit_App : 



B_CALL ReloadAppEntryVecs ; load the monitor vectors 

; to App loader 

A, kTrace 

_JUMP JForceGraphNoKey ; exit the app 



LD 
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MemClear 

Category: Utility 

Description: Clears a memory block (to OOh's). 
Input: 

Registers: BC = number of bytes in block 

HL = address of first byte in memory block 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: Memory block cleared 

Registers A, BC, DE, HL 
destroyed: 

Remarks: BC must be > 1 

Example: TBD 
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MemSet 

Category: 

Description: 

Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Utility 

Sets a memory block to a given value. 



A = value to set all bytes in memory block 

BC = number of bytes in block 

HL = address of first byte in memory block 

None 

None 



None 
None 

Memory block set 
BC, DE, HL 

BC must be > 1 
TBD 
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Mov7B, Mov8B, Mov9B, MovlOB, Mov18B 

Category: Utility 

Description: Copies a short memory block where X = MovXB, where X is the number of 
bytes. 

Inputs: 

Registers: HL = start of source block 

DE = start of destination block 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: Block starting at original HL copied to area starting at original DE. 

Registers BC, DE, HL 
destroyed: 

Remarks: 
Example: 
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Mov90P1 OP2 

Utility 



Category: 
Description: 



Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Copies a block of 18 bytes of RAM/ROM to OP1/OP2, with the first nine- 
bytes to OP1 and the second nine-bytes to OP2. 
This is most commonly used to copy a complex element of either a list or 
matrix to OP1/OP2, skipping the 10th and 11th bytes of OP1. 

HL = pointer to start of 18 bytes to copy 

None 

None 

DE = DE + 18 
None 

First nine-bytes OP1 and first nine-bytes of OP2 contain the 18 bytes 
copied. 

All but ACC 



Copy the first element of complex list L1 to OP1/OP2: 



LD 


HL, Llname 






RST 


rMov9ToOPl 


; OP1 


= LI name 


B_CALL 


FindSym 


; look 


up, DE = pointer to data 


EX 


DE, HL 


; HL = 


pointer to data 


INC 


HL 






INC 


HL 


; HL = 


pointer to 1st element 


B_CALL 


Mov90P10P2 


; OP1 


= real part, OP2 = image 






; part 


of element 1 


RET 
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Mov90P2Cp 

Utility 



Category: 
Description: 

Inputs: 

Registers: 

Flags: 

Others: 
Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 
Example: 



Copies a floating-point number from RAM/ROM to OP2 and compares it to a 
floating-point number in OP1. 



HL = pointer to floating point to copy to OP2 
None 

OP1 = floating-point number 
None 

Z= 1 if OP1 =OP2 

Z = 0,CA=1:OP1 <OP2 

Z = 0, CA = 0:OP1 OP2 

OP1 = intact 

OP2 = floating-point number copied 
All 

Both OP1 and the float copied to OP2 are preserved. 

Copy the first element of real list L1 to OP2 and compare it to a floating- 
point number in OP1 . 



LD 


HL, Llname 




RST 


rMov9ToOPl 




B_CALL 


FindSym 


f 


EX 


DE, HL 


f 


INC 


HL 




INC 


HL 


r 


B_CALL 


Mov90P2Cp 




RET 







; HL = pointer to 1st element 
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Mov9ToOP1 



Category: Utility 

Description: Copies nine-bytes of RAM/ROM to OP1 . 
Inputs: 

Registers: HL = pointer to the nine-bytes to copy 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 contains the nine-bytes 

Registers All but ACC 
destroyed: 



Remarks: 
Example: 



B_CALL 



Mov9ToOPl 



TI-83 Plus Developer Guide 



16-24 



Third Release January 25, 2002 



System Routines - Utility 



Mov9ToOP2 



Category: Utility 

Description: Copies nine-bytes of RAM/ROM to OP2. 
Inputs: 

Registers: HL = pointer to the nine-bytes to copy 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP2 contains the nine-bytes 

Registers All but ACC 
destroyed: 



Remarks: 
Example: 



B_CALL 



Mov9ToOP2 
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MovFrOPI 

Category: Utility 

Description: Copies OP1 (nine bytes) to another RAM location. 
Inputs: 

Registers: DE = pointer to destination of move 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: HL = OP1 + 9 

DE = DE + 9 

OP1 copied to (DE) 

Registers All but ACC 
destroyed: 

Remarks: 
Example: 
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NZIf83Plus 



Category: Utility 

Description: Returns status if calculator is TI-83 Plus or not. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 



Flags: 



Others: 

Registers 
destroyed: 

Remarks: 



Example: 



NZ = status if TI-83 Plus 

Z = status if TI-83 Plus Silver Edition 

None 

None 



This BCALL is not available on TI-83 Plus version 1.12 or earlier. The 
calling routine must check the software version before performing this 
B CALL. This routine is not as intrusive as GetSyslnfo if all you need to 
know is if the calculator is an earlier edition of TI-83 Plus. 



See GetBaseVer, GetSyslnfo 

Return NZ if running on TI-83 Plus 



B_CALL GetBaseVer 

CP 1 

JR C, MustBe83Plus 

JR NZ, Abovell2 

LD A, B 

CP 13 

JR NC, abovell2 



OS version in A, B 
check major version 
if 0.x, then < 1.13 
if 2.x, then > 1.12 
major version = 1 
check minor version 
C if minor version < 13 



MustBe83Plus : 



RET 



Abovell2 : 



B_CALL 
RET 



NZIf 83P1US 



; later than 1 . 12 
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OP1ExOP2, OP1ExOP3, OP1ExOP4, OP1ExOP5 5 
OP1 ExOP6 5 OP2ExOP4, OP2ExOP5, OP2ExOP6, 
OP5ExOP6 

Category: Utility 

Description: Exchanges 1 1 -byte contents of OP(x) with OP(y). 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP(X) = former contents of OP(Y) 
OP(Y) = former contents of OP(X) 

Registers A, BC, DE, HL 
destroyed: 

Remarks: Combinations Available: 

(y) OP1 OP2 OP3 OP4 OP5 OP6 

(x) 

OP1 X X X X X 

OP2 XXX 
OP3 
OP4 

OP5 X 
OP6 

Example: ; Exchange contents of OP2 and OP4 

B_CALL OP2ExOP4 
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OP1ToOP2 5 OP1ToOP3 5 OP1ToOP4 5 OP1ToOP5 5 
OP1ToOP6, OP2ToOP1, OP2ToOP3, OP2ToOP4, 
OP2ToOP5, OP2ToOP6, OP3ToOP1 , OP3ToOP2, 
OP3ToOP4, OP3ToOP5, OP4ToOP1 , OP4ToOP2 5 
OP4ToOP3, OP4ToOP5, OP4ToOP6, OP5ToOP1 5 
OP5ToOP2, OP5ToOP3, OP5ToOP4, OP5ToOP6, 
OP6T0OPI , OP6ToOP2, OP6ToOP5 

Category: Utility 

Description: Copies 1 1 bytes from OP(x) to OP(y). 
Inputs: 

Registers: None 

Flags: None 

Others: OP(x) 
Outputs: 

Registers: None 

Flags: None 

Others: OP(y) = former contents of OP(x) 

Registers BC, DE, HL 
destroyed: 

Remarks: Combinations Available: 



Dest(y) OP1 OP2 OP3 OP4 OP5 OP6 
Source(x) 



OP1 




X 


X 


X 


X 


X 


OP2 


X 




X 


X 


X 


X 


OP3 


X 


X 




X 


X 




OP4 


X 


X 


X 




X 


X 


OP5 


X 


X 


X 


X 




X 


OP6 


X 


X 






X 





Example: b_call opitoop3 
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PosNoOInt 

Category: Utility 

Description: Checks if OP1 is a positive non-zero integer floating point. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point number 
Outputs: 

Registers: None 

Flags: Z = 1 if OP1 = positive non 0 integer 
Z = 0 if non integer or negative or 0 

Others: None 

Registers ACC 
destroyed: 

Remarks: 

Example: 
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PutAway 



Category: Utility 

Description: Force application to be put away. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 



Others: 

Registers 
destroyed: 

Remarks: 



Example: 



Application is terminated. 
ALL 

Applications should not use this routine for normal exit code. Applications 
should only use this entry point as part of putaway code in "Stand-Alone with 
Putaway Notification" mode. See Chapter 2: "Entering and Exiting an 
Application Properly". 

AppPutAway : 



Application gets itself ready for terminating by cleaning any system flags 
or saving any information it needs to. 



RES 
RES 



plotLoc, (IY+plotFlags) 
textWrite, ( IY+sGrFlags ) 



draw to display & buffe 
small font written to 
display 

; This next call resets the monitor control vectors back to the App Loader 



B CALL 



ReloadAppEntryVecs 



; App Loader in control o 
; monitor 



LD ( IY+textFlags ) , 0 ; reset text flags 

This next call is done only if application used the Graph Backup Buffer 

B_CALL SetTblGraphDraw 

Need to check if turning off or not, the following flag is set when 
turning off: 



BIT 
JR 



MonAbandon, ( IY+monFlags ) ; turning off ? 
NZ, TurningOff ; jump if yes 



if not turning off then force control back to the home screen 

note: this will terminate the link activity that caused the application 
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; to be terminated. 



LD 
OUT 

B_CALL 

SET 

EI 



A, iall 

(intrptEnPort) , A 
LCD_DRIVERON 
onRunning, (IY+onFlags) 



; all interrupts on 

; turn on LCD 

; on interrupt running 

; enable interrupts 



_JUMP 



JForceCmdNoChar 



; force to home screen 



TurningOf f : 



B_JUMP 



Putaway 



; force App loader to do its 
; put away 
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RclAns 



Category: Utility 

Description: Recalls answer to OP1 [,OP2] or at least set up pointers to it. 
Inputs: 

Registers: None 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 [,OP2] if real [or complex] 
AF, BC, DE, HL, 



Registers 
destroyed: 

Remarks: 



Example: 



Entire code: 



CALL 
JP 



AnsName ; see these routines for more 

; info 

RclVarSym ; see these routines for more 

; info 



AnsName puts the name of Ans into 

OP1 = 00h,tAns,00h,00h, OOh 

= 00h,072h,00h,00h, OOh 

RclVarSym will recall the contents of the variable to OP1 if it is real, to OP1 
and OP2 if the variable is complex and otherwise leaves the name as is in 
OP1 and returns HL as the symbol table pointer and DE as the data pointer 
as in ChkFindSym. 



B_CALL 



LD 

B_CALL 



RclAns 



DispOPlA 



This example presumes that 
you already know that Ans is 
a Real number, 
display up to 8 digits 
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ReloadAppEntryVecs 



Category: 
Description: 



Inputs: 

Registers: 

Flags: 

Others: 

Outputs: 

Registers: 

Flags: 

Others: 

Registers 
destroyed: 

Remarks: 

Example: 



Utility 

Sets the system monitor vector table to the Application loader context. 

This routine is used by advanced applications that override the system 
monitor vector table. This routine should be called by the application just 
before exiting. 

This routine should only be used by applications, not ASM programs. 

None 
None 
None 

None 
None 

Monitor system vectors are now set to the application loader. 
All 



Assume we have an application that overrode the monitor vectors and our 
application is exiting because the user pressed the [Quit] key. 



ChkForQuit : 



CP kQuit 

JR NZ,notQuit 

B_CALL ReloadAppEntryVecs 

B_JUMP JForceCmdNoChar 



quit key? 
jump if no 

restore monitor to 
application loader 
switch to the home 
screen 
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SetExSpeed 

Category: Utility 

Description: Set execution speed to fast or slow. 
Inputs: 

Registers: A = 0 to set slow speed (6Mhz) 

A = 1 to set 15Mhz 

A = FF to set fastest future speed 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers Flag register modified 
destroyed: 

Remarks: This BCALL is not available on TI-83 Plus version 1 .1 2 or earlier. The 
calling routine must check the software version before performing this 
B CALL. This routine is not as intrusive as GetSyslnfo if all you need to 
know is if the calculator is an earlier edition of TI-83 Plus. 

See GetBaseVer, GetSyslnfo 

This routine can be called on a TI-83 Plus unit running software version 1 .13 
and higher, but will not effect the operating speed of that unit. 

On the TI-83 Plus Silver Edition, the operating system will set the speed 
back to fast once the application or assembly program returns, regardless of 
any settings changed. An exception to this is that the error handler will 
leave the speed setting intact in the event a GoTo is desired. 

Some system routines such as the IO utilities may set slow speed for certain 
operations. These routines will restore the current speed upon completion. 
Other routines, such as JforceCmdNoChar force fast speed. Normally an 
application will not execute these routines except on completion. 

(continued) 
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Example: 



Set fast speed if running on 1 .13 or higher. 



B_CALL 

CP 

JR 

CP 

JR 

LD 

CP 

JR 



GetBaseVer 
2 

NC, Abovell2 
1 

NZ, Belowll2 
A, B 

13 

C, Belowll2 



OS version in A, B 
check major version 
if 2.x, then > 1.12 
if 0.x, then < 1.12 
major version = 1 

check minor version 

C if minor version < 13 



Abovell2 : 



Belowll2 : 



LD 

B_CALL 
JR 



A, OFFh 

SetExSpeed 

Done 



; set fastest speed possible 



; earlier than 1 . 12 



Done : 
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SetXXOPI 

Category: Utility 

Description: Sets OP1 equal to a floating-point integer between 0 and 99. 
Inputs: 

Registers: ACC = integer value to set OP1 equal to 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = floating-point integer between 0-99 

Registers All 
destroyed: 

RAM used: OP1 

Remarks: No error checking is done for invalid input. 
Example: Set OP1 = 75. 

LD A, 75 

B_CALL SetXXOPI ; OP1 = floating point 75 
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SetXXOP2 

Category: Utility 

Description: Sets OP2 equal to a floating-point integer between 0 and 99. 
Inputs: 

Registers: ACC = integer value to set OP2 equal to 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP2 = floating-point integer between 0-99 

Registers All 
destroyed: 

RAM used: OP2 

Remarks: No error checking is done for invalid input. 
Example: Set OP2 = 75. 

LD A, 75 

B_CALL SetXXOP2 ; OP2 = floating point 75 
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SetXXXXOP2 

Category: Utility 

Description: Sets OP2 equal to a floating-point integer between 0 and 65535. 
Inputs: 

Registers: HL = integer value to set OP2 equal to 

Flags: None 

Others: None 
Outputs: 

Registers: None 

Flags: None 

Others: OP2 = floating-point integer between 0 - 65535 

Registers All 
destroyed: 

RAM used: OP2 

Remarks: 

Example: Set OP2 = 7523. 

LD HL,7523 

B_CALL SetXXXXOP2 ; OP2 = floating point 7523 
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StoRand 



Category: 



Utility 



Description: Initializes random number seeds on OP1 value. 
Inputs: 

Registers: None 

Flags: None 

Others: OP1 = real number OeO ... < 1 E9 
Outputs: 

Registers: None 

Flags: None 

Others: OP1 = same value as unmodified input. 

Registers All 
destroyed: 



RAM used: 
Remarks: 



OP1, OP2, OP6 

Storing a 0 to the seed will reinitialize the random number generator to its 
original state from the factory. 

The input value in OP1 must be a real number, but it does not have to fall 
within the specified range. If it does not, it will be modified (exponent 
reduced, sign changed, and truncated) to fit in the range. 



Example: 
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StrCopy 



Category: Utility 

Description: Copy a null-terminated string in memory. 
Inputs: 

Registers: HL = starting address of source string 

DE = starting address of destination 

Flags: None 

Others: None 

Outputs: 

Registers: None 

Flags: None 

Others: None 

Registers A, DE, HL 
Destroyed: 

Remarks: This is like a C language StrCpy() function. 
When complete: 

? HL is left pointing to the null terminator of the source string. 
? DE is left pointing to the null terminator of the destination string. 

Example: 
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StrLength 

Category: Utility 

Description: Returns the length of a zero (0) terminated string residing in RAM. 
Inputs: 

Registers: HL = pointer to start of zero terminated string, in RAM 

Flags: None 

Others: None 
Outputs: 

Registers: BC = length of string, not including terminating 0 

Flags: None 

Others: None 

Registers BC 
destroyed: 

Remarks: 
Example: 
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17 



System Routines 
Miscellaneous 



ConvOPI 17-1 
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ConvOPI 

Category: Miscellaneous 

Description: Converts a floating-point number in OP1 to a two-byte hexadecimal number 
in DE. 

Inputs: 

Registers: OP1 = floating-point number 

Flags: None 

Others: None 

Outputs: 

Registers: A = LSB hex value 

DE = entire hex value 
If OP1 exponent > 3 error 

Flags: None 

Others: None 

Registers 
destroyed: 

Remarks: 

Example: 
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R 



Reference List — 
System Routines 



Abs0102Cp 

Abs01PAbs02. 

ACos 

ACosH 

ACosRad 



10-1 



10-2 



10-3 



10-4 



10-5 



AdrLEle 9-1 



See Math 
See Math 
See Math 
See Math 
See Math 
See List 



AdrMEle 11-1, See Matrix 



AdrMRow 11-2, See Matrix 



AIIEq 1 5-1 J See Graphing and Drawing 

AllocFPS \±T\ See Floating Point Stack 



AllocFPSI 4-2. See Floating Point Stack 



Angle 10-6 See Math 



AnsName |16-2] See Utility 



ApdSetup |8-1 1 See Keyboard 

AppGetCalc See IO 

AppGetCbl \T2\ See IO 

Applnit 1 1 6-jJ See Utility 

See Memory 
See Math 



ArcJJnarc 12-1 

ASin 



10-7 



ASinH 10-8 See Math 



10-10 See Math 



10-11 See Math 



ASinRad 10-9, See Math 

ATan 

ATan2 

ATan2Rad 

ATanH 

ATanRad 



10-12 See Math 



10-13 See Math 



10-14 See Math 



B 

BinOPExec 1 1 3- 1 J See Parser 

Bit_VertSplit O See Display 



BufClr 1 5-2 1 See Graphing and Drawing 



BufCpy 5-3 See Graphing and Drawing 
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CAbs 10-15 See Math 



CAdd 10-16 See Math 



CanAlphlns |8-2] See Keyboard 

CDiv |1 0-1 7| See Math 

CDivByReal 



10-18 



See Math 



CEtoX 10-19 See Math 



CFrac 10-20 See Math 



10-22 



10-23 



10-24 



CheckSplitFlag \^2j See Display 

ChkFindSym |12-2J See Memory 

Clntgr |1 0-21 J See Math 

CircCmd |5-4| See Graphing and Drawing 

Cklnt 

CkOdd 

CkOPICO 

CkOPICplx 

CkOPIFPO 

CkOPIPos 

CkOPIReal 

CkOP2FP0 

CkOP2Pos 

CkOP2Real 



10-25 



10-26 



10-27 



10-28 



10-29 



10-30 



10-31 



CkPosInt 10-32 



CkValidNum 10-33 



See Math 
See Math 
See Math 
See Math 
See Math 
See Math 
See Math 
See Math 
See Math 
See Math 
See Math 
See Math 



CleanAII |12-4j See Memory 

ClearRect |5-6| See Graphing and Drawing 

ClearRow |1-3j See Display 

CLine 

CLineS 



5-7 



See Graphing and Drawing 
See Graphing and Drawing 
CLN |10-34| See Math 



5-9 



CLog |10-35J See Math 

CloseEditBuf I2TI See Edit 

CloseEditBufNoR 



2-2 



See Edit 



CloseEditEqu \^3\ See Edit 

CloseProg |12-5| See Memory 

ClrGraphRef |5-1 1| , See Graphing and Drawing 

ClrLCD 



1-4 



See Display 

ClrLCDFull [1J5] See Display 

ClrLp |10-36| See Math 
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ClrOPIS 10-37, See Math 



ClrOP2S [L6J See Display 

ClrScrn [w] See Display 

ClrScrnFull \Tls\ See Display 

ClrTxtShd m^Se e Display 

CMItByReal |10-38| See Math 

CmpSyms |12-6] See Memory 

CMult |1 0-39,| See Math 

Conj |1 0-40,| See Math 

ConvDim [9^2] See List 



ConvDimOO 1 1 6-3 J See Utility 

ConvLcToLr [9^31 See List 



ConvLrToLc l^M] See List 

ConvOPI |1 7-1 [ See Miscellaneous 

COP1 SetO |1 0-41 1 , See Math 

Cos 1 10-42j See Math 

CosH 1 10-431 See Math 

CpHLDE |16-5J See Utility 

CPoint 



5-12 



See Graphing and Drawing 

CPointS 1 5-14] See Graphing and Drawing 

CpOP10P2 |10-44| See Math 

CpOP40P3 110-451 See Math 



Cpy01ToFPS1 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy01ToFPS2 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy01ToFPS3 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy01ToFPS4 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy01ToFPS5 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy01ToFPS6 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy01ToFPS7 


4 


-4, 


See 


Floating 


Point 


Stack 


CpyOUoFPST 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy02ToFPS1 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy02ToFPS2 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy02ToFPS3 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy02ToFPS4 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy02ToFPST 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy03ToFPS1 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy03ToFPS2 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy03ToFPST 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy05ToFPS1 


4 


-4, 


See 


Floating 


Point 


Stack 


Cpy05ToFPS3 


4 


-4, 


See 


Floating 


Point 


Stack 
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Cpy06ToFPS2 . 
Cpy06ToFPST. 

CpyStack 

CpyTo1FPS1 .... 
CpyTo1FPS10.. 
CpyTo1FPS11 .. 
CpyTo1FPS2.... 
CpyTo1FPS3.... 
CpyTo1FPS4.... 
CpyTo1FPS5.... 
CpyTo1FPS6.... 
CpyTo1FPS7.... 
CpyTo1FPS8.... 
CpyTo1FPS9.... 
CpyTolFPST.... 
CpyTo2FPS1 .... 
CpyTo2FPS2.... 
CpyTo2FPS3.... 
CpyTo2FPS4.... 
CpyTo2FPS5.... 
CpyTo2FPS6.... 
CpyTo2FPS7.... 
CpyTo2FPS8.... 
CpyTo2FPST.... 
CpyTo3FPS1 .... 
CpyTo3FPS2.... 
CpyTo3FPST.... 
CpyTo4FPST.... 
CpyTo5FPST.... 
CpyTo6FPS2.... 
CpyTo6FPS3.... 
CpyTo6FPST.... 

CpyToFPSI 

CpyToFPS2 

CpyToFPS3 

CpyToFPST 



4-4 


See 


Float 
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See 


Float 
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CreateOEqu .... 
CreateAppVar. 
CreateCList .... 



112-71 See Memory 
12-8j See Memory 
12-9) See Memory 
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CreateCplx 

CreateEqu 

CreatePair 

CreatePict 

CreateProg 

CreateProtProg 

CreateReal 

CreateRList 

CreateRMat 

CreateStrng 



12-10 

12-11 

12-12 , 

12-13 , 

12-14 , 

12-15 

12-16 

12-17 

12-18 , 

12-19, 



See Memory 
See Memory 
See Memory 
See Memory 
See Memory 
See Memory 
See Memory 
See Memory 
See Memory 
See Memory 



CRecip 10-46, See Math 



CSqRoot 10-47, See Math 



CSquare 10-48, See Math 



CSub 10-49 See Math 



CTenX |10-50| See Math 

CTrunc 110-51 1 See Math 



Cube 10-52 See Math 



CursorOff 2-4 See Edit 



CursorOn 2-5 See Edit 



CXrootY 10-53 See Math 



CYtoX 10-54 See Math 



DarkLine 

DarkPnt 

DataSize 

DataSizeA .... 
DeallocFPS .. 
DeallocFPSI . 



5-16| See Graphing and Drawing 
5-18| See Graphing and Drawing 
12-20| See Memory 
See Memory 
See Memory 
See Memory 



12-21 



12-22 



12-23 



Dec01 Exp 10-55, See Math 



DelListEl 9-5 See List 



DelMem |12-24| See Memory 

DelRes |15-1| See Statistics 

DelVar 

DelVarArc 

DelVarNoArc 



12-26 



12-27 



12-28, 



See Memory 
See Memory 
See Memory 



DisableApd 16-6, See Utility 



Disp 5-20 See Graphing and Drawing 



DispDone |1-10| See Display 



DispEOL 2-6, See Edit 
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DispHL |1-11| See Display 

Displaylmage |1-12| See Display 



DispOPIA |1-14| See Display 

DivHLBylO See Interrupt 

DivHLByA H^U See Interrupt 

DrawCirc2 |5-21 I See Graphing and Drawing 



DrawCmd 5-23 See Graphing and Drawing 



DrawRectBorder 5-24 See Graphing and Drawing 



DrawRectBorderClear 5-25 See Graphing and Drawing 



DToR 10-56, See Math 



EditProg |12-29| See Memory 



EnableApd 16-7, See Utility 



EnoughMem 1 12-301 See Memory 

EOPINotReal |T&5] See Utility 

Equ_or_NewEqu |1 6-9] See Utility 



EraseEOL |1-15| See Display 



EraseRectBorder 5-26 See Graphing and Drawing 



ErrBadGuess [HH See En 



ErrD OP1 0. 



ErrD OP1 LE 0 3-5 See Er 



ErrD OPINot R 3-6 See Er 



ErrD OPINotPos 3-7 See Er 



ErrD OPINotPosInt 3-8 See Er 



ErrDataType |3_j3| See En 



ErrDimension 3-10 See Er 



ErrDomain 3-13 See En 



Errlncrement 3-14 See En 



Errlnvalid 3-15 See En 



Errlterations 3-16 See En 



ErrLinkXmit 3-17 See En 



ErrMemory 3-18 See En 



ErrNon Real 3-19 See Er 



ErrNotEnoughMem 3-21 



13-1 


See Erro 


|3-2 


See Erro 


3-3 


See Erro 


3-4 


See Erro 


3-5 


See Erro 


3-fi 


See Erro 


3-7 


See Erro 


3-8 


See Erro 


3-9 


See Erro 


3-10 


See Erro 


3-11 


See Erro 


3-12 


See Erro 


3-13 


See Erro 


3-14 


See Erro 


3-15 


See Erro 


3-16 


See Erro 


3-17 


See Erro 


3-18 


See Erro 


3-19 


See Erro 






3-20 


See Erro 


3-21 


See Erro 
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ErrOverflow 3-22 See Error 



ErrSignChange |3-23j See Error 

ErrSingularMat ]3-24[ See Error 

ErrStat J 3-251 See Error 



ErrStatPlot 3-26 See Error 



ErrSyntax 3-27 See Error 

ErrTolTooSmall J3-28J See Error 



ErrUndefined 3-29 See Error 



EToX 10-57 See Math 



Exch9 |1 2-31j See Memory 



ExLp |12-32| See Memory 

ExpToHex 



10-58, See Math 



Factorial 10-59 See Math 



12-33| See Memory 



12-35 See Memory 



FillRect |5-27| See Graphing and Drawing 

FillRectPattern |5-29| See Graphing and Drawing 

Find_Parse_Formula 1 9-6 J See List 

FindAlphaDn 

FindAlphaUp 

FindApp 

FindAppDn 

FindAppNumPages 

FindAppUp 

FindSym 



12-37J See Memory 



12-38, 



12-39] See Memory 
See Memory 
See Memory 
See Memory 



12-40, 



12-41 



FiveExec 13-3. See Parser 



FixTempCnt 1 12-43,1 See Memory 

FlashToRam 1 12-44 J See Memory 

ForceFullScreen 14-1, See Screen 

FormBase |1-16J See Display 

FormDCplx H-18J See Display 

FormEReal |1-20| See Display 

FormReal H-21 1 See Display 



10-60 



10-61 



FourExec |13-5| See Parser 

FPAdd 

FPDiv 

FPMult 

FPRecip 

FPSquare 

FPSub 



10-62 



10-63 



10-64 



10-65 



See Math 
See Math 
See Math 
See Math 
See Math 
See Math 
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Frac 10-66 See Math 



Get_Tok_Strng 16-14, See Utility 



GetBaseVer |16-1C| , See Utility 



GetCSC [£K3j See Keyboard 



GetKey |8-6,| See Keyboard 



GetLToOPI 9-7 See List 



GetMToOPI 11-3, See Matrix 

See Utility 



GetTokLen 16-11 



GrBufClr 1 5-31 [ See Graphing and Drawing 



GrBufCpy j5-32[ See Graphing and Drawing 



GrphCirc 5-33 See Graphing and Drawing 



H 



HLTimes9 1 0-67 See Math 



HorizCmd |5-34j See Graphing and Drawing 



HTimesL 10-68 See Math 



I 



IBounds |5-35j See Graphing and Drawing 



IBoundsFull |5-36] See Graphing and Drawing 



ILine |5-37| See Graphing and Drawing 

IncLstSize [{Mi] See List 



InsertList 9-10 See List 



InsertMem 12-45J See Memory 

Int 



10-69 See Math 



Intgr |10-70| See Math 



InvCmd 5-39, See Graphing and Drawing 



InvertRect |5-40j See Graphing and Drawing 

InvOPIS 11 0-71 J See Math 



InvOPISC 10-72 See Math 



lnvOP2S 10-73, See Math 



InvSub 10-74 See Math 



lOffset |10-41l See Graphing and Drawing 



IPoint 10-42, See Graphing and Drawing 



lsA2ByteTok 16-15 See Utility 



IsEditEmpty \£7\ See Edit 

J 



JError 3-30. See Error 
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JErrorNo 3-31 See Error 



JForceCmdNoChar |1 6-161 See Utility 



JForceGraphKey 16-17 See Utility 



JForceGraphNoKey |16-18j See Utility 

K 



KeyToString [2JJ] See Edit 



LdHLInd |1 2-47J See Memory 



LineCmd |5-44| See Graphing and Drawing 



LnX 10-75 See Math 



Load_SFont 1-23 See Display 



LoadClndPaged |12-47| See Memory 



LoadDEIndPaged 12-49, See Memory 



LoadPattern 1 1-22 J See Display 



LogX 10-76 See Math 



M 



Max 



1 0-77 See Math 



MemChk 12-50 See Memory 



MemClear I16-19J See Utility 



MemSet [16-20] See Utility 

Min 110-78] See Math 



Minusl 110-79 J See Math 

Mov10B 

Mov18B 

Mov7B 

Mov8B 

Mov9B 

Mov90P10P2 

Mov90P2Cp 

Mov9ToOP1 

Mov9ToOP2 

MovFrOPI 



16-21 
16-21 
16-21 
16-21 
16-21 



16-22 



16-23 



16-24 



16-25 



16-26 



See Utility 
See Utility 
See Utility 
See Utility 
See Utility 
See Utility 
See Utility 
See Utility 
See Utility 
See Utility 



N 



NewLine 1-24 See Display 



OneVar 15-2 See Statistics 
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OP1ExOP2 

OP1ExOP3 

OP1ExOP4 

OP1ExOP5 

OP1ExOP6 

OP1 ExpToDec. 

OPISetO 

OP1Set1 

OP1Set2 

OP1Set3 

OP1Set4 

OP1ToOP2 

OP1ToOP3 

OP1ToOP4 

OP1ToOP5 

OPU0OP6 

OP2ExOP4 

OP2ExOP5 

OP2ExOP6 

OP2SetO 

OP2Set1 

OP2Set2 

OP2Set3 

OP2Set4 

OP2Set5 

OP2Set60 

OP2Set8 

OP2SetA 

OP2ToOP1 

OP2ToOP3 

OP2ToOP4 

OP2ToOP5 

OP2ToOP6 

OP3SetO 

OP3Set1 

OP3Set2 

OP3ToOP1 

OP3ToOP2 

OP3ToOP4 

OP3ToOP5 





16-28 


See Utility 




16-28 


See Utility 




16-28 


See Utility 




16-28 


See Utility 




16-28 


See Utility 




10-80 


See Math 




10-81 


, See Math 




10-81 


, See Math 




10-81 


, See Math 




10-81 


, See Math 




10-81 


, See Math 




16-29 


See Utility 




16-29 


See Utility 




16-29 


See Utility 




16-29 


See Utility 




16-29 


See Utility 




16-28 


See Utility 




16-28 


See Utility 




16-28 


See Utility 




10-81 


See Math 




10-81 


See Math 




10-81 


See Math 




10-81 


See Math 




10-81 


See Math 




10-81 


See Math 




10-81 


See Math 




10-82 


See Math 




10-83 


, See Math 




16-29 


See Utility 




16-29 


See Utility 




16-29 


See Utility 




16-29 


See Utility 




16-29 


See Utility 




10-81 


See Math 




10-81 


See Math 




10-81 


See Math 




16-29 


See Utility 




16-29 


See Utility 




16-29 


See Utility 




16-29 


See Utility 
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OP4SetO 10-81 

OP4Set1 |l0-81 

OP4ToOP1 116-29, 

OP4ToOP2 16-29, 

OP4ToOP3 16-29, 

OP4ToOP5 16-29, 

OP4ToOP6 16-29, 

OP5ExOP6 16^28" 

OP5SetO JltHST 

OP5ToOP1 FRT29 

OP5ToOP2 16-29 

OP5ToOP3 16-29 

OP5ToOP4 16-29 

OP5ToOP6 16-29 

OP6ToOP1 16-29 

OP6ToOP2 16-29 

OP6ToOP5 16-29 



See Math 
See Math 



See Uti 


ity 


See Uti 


ity 


See Uti 


ity 


See Uti 


ity 


See Uti 


ity 


See Uti 


ity 


See Math 


See Uti 


ity 


See Uti 


ity 


See Uti 


ity 


See Uti 


ity 


See Uti 


ity 


See Uti 


ity 


See Uti 


ity 


See Uti 


ity 



OutputExpr |1-24| See Display 



PagedGet 1 1 2-51 J See Memory 

Parselnp |13-7J See Parser 

PDspGrph |5-46,| See Graphing and Drawing 

PixelTest |5-47,| See Graphing and Drawing 

Plusl |1 0-84J See Math 

PointCmd |5-48j See Graphing and Drawing 

PointOn |5-50] See Graphing and Drawing 

PopMCplxOI 

PopOPI 

PopOP3 

PopOP5 

PopReal 

PopRealOl 

PopReal02 

PopReal03 

PopReal04 

PopReal05 

PopReal06 



ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 

PosNoOInt |16-"30] See Utility 

PtoR 110-851 See Math 



4-11, 


See Floati 


4-12, 


See Floati 


4-12, 


See Floati 


4-12, 


See Floati 


4-13, 


See Floati 


4-14, 


See Floati 


4-14, 


See Floati 


4-14, 


See Floati 


4-14, 


See Floati 


4-14, 


See Floati 


4-14, 


See Floati 



TI-83 Plus Developer Guide 



R-11 



Third Release January 25, 2002 



Reference List - System Routines 



PushMCplxOI 
PushMCplx03 

PushOPI 

PushOP3 

PushOP5 

PushReal 

PushRealOl ... 
PushReal02... 
PushReal03... 
PushReal04... 
PushReal05... 
PushReal06... 



4-15, 


See Floati 


4-15, 


See Floati 


4-16, 


See Floati 


4-16, 


See Floati 


4-16, 


See Floati 


4-17, 


See Floati 


4-18, 


See Floati 


4-18, 


See Floati 


4-18, 


See Floati 


4-18 


See Floati 


4-18, 


See Floati 


4-18, 


See Floati 



ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 
ng Point Stack 



PutC |1-26] See Display 

PutMap |1-27J See Display 

PutPS I1-28J See Display 

PutS |1-32J See Display 

PutTokString H-34J See Display 

PutToL ...19-12] See List 

PutToMat |11-4,| See Matrix 



Randlnit 10-86 See Math 



Random 10-87 See Math 



Rcl StatVar 15-3, See Statistics 



RclAns .-I16-33J See Utility 

RclGDB2 |12-52J See Memory 

RcIN |12-53j See Memory 

RclSysTok |13-9,| See Parser 

RclVarSym 1 12-54 J See Memory 

See Memory 
See Memory 



RclX J 12-55] See Memory 

RclY 



12-56 



RedstByte ]7-3,| See IO 

Red stByteNC ] 7-4,1 See 10 

RecABytelO ]7-5,| See 10 

RedimMat |12-57] See Memory 

Regraph 1 5-51 ,| See Graphing and Drawing 

ReleaseBuffer 1 2-9, | See Edit 

ReloadAppEntryVecs 1 16-34] See Utility 

RestoreDisp |1-35| See Display 

RName |1 0-88] See Math 
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RndGuard 

RnFx 

Round 

RToD 

RToP 

RunlndicOff 

RunlndicOn 1-37 J See Display 



, 1 0-89 
. 10-90 . 
10-91 
. 10-92 

Tom 



See Math 
See Math 
See Math 
See Math 

See Math 

jg] See Display 



SaveDisp |1-38,|See Display 

SendAByte J 7-6,1 See 10 

SendVarCmd J 7-6 J See 10 

SetAIIPIots 

SetFuncM 



5-52, 



5-53, 



See Graphing and Drawing 
See Graphing and Drawing 

SetNorm_Vals |1-39,| See Display 

SetParM |5-54j See Graphing and Drawing 

SetPolM 5-55, See Graphing and Drawing 

SetSeqM |5-56j See Graphing and Drawing 

SetTblGraphDraw |5-57j See Graphing and Drawing 

SetupPagedPtr |12-58J See Memory 

SetXXOPI |1 6-37,| See Utility 

SetXXOP2 |1 6-38,1 See Utility 

SetXXXXOP2 116-39] See Utility 

SFont_Len 1 1-40,1 See Display 

Sin |1 0-94,1 See Math 

SinCosRad |10-95,| See Math 

SinH |1 0-96,| See Math 

SinHCosH |1 0-97,1 See Math 



SqRoot |1 0-98,| See Math 

SrchVLstDn, SrchVLstUp ] 12-59] See Memory 

SStringLength |1-41 ,| See Display 

StMatEl |1 2-60,| See Memory 

StoAns |1 2-61,| See Memory 

StoGDB2 |1 2-62J See Memory 

StoN |1 2-63J See Memory 

StoOther |12-64,| See Memory 

StoR |1 2-66,| See Memory 

StoRand |1 6-40, | See Utility 

StoSysTok |12-67,| See Memory 

StoT 1 12-68,1 See Memory 
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StoTheta. 

StoX 

StoY 



12-69, 
12-70, 
12-71, 



See Memory 
See Memory 
See Memory 



StrCopy |1 6-41, | See Utility 



StrLength 1 16-42,1 See Utility 



Tan. 



TanH 10-100 



10-99, 



See Math 
See Math 



TanLnF 5-58, See Graphing and Drawing 



TenX 110-101] See Math 



ThetaName 10-102 See Math 



ThreeExec 13-10, See Parser 



Times2 1 0-1 03, See Math 



TimesPt5 1 0-1 04, See Math 



TName 10-105, See Math 



ToFrac 10-106, See Math 



Trunc 10-107, See Math 



TwoVarSet 15-4, See Statistics 



U 



UCLineS 5-59, See Graphing and Drawing 



UnLineCmd 5-60, See Graphing and Drawing 



UnOPExec 13-12, See Parser 



VertCmd 5-61 , See Graphing and Drawing 



VPutMap |1-42,| See Display 



VPutS 1 1-43,1 See Display 



VPutSN |1 -45,1 See Display 



VtoWHLDE 1 5-62 J See Graphing and Drawing 

X 



Xftol 5-63, See Graphing and Drawing 



Xitof 1 5-64 J See Graphing and Drawing 



XName 10-108 See Math 



XRootY 10-109, See Math 



Yftol 1 5-65,1 See Graphing and Drawing 

YName |1 0-110] See Math 
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YToX. 



10-111. 



See Math 



Zero16D .... 

ZeroOP 

ZeroOPI .... 
ZeroOP2.... 
ZeroOP3.... 
ZmDecml ... 

ZmFit 

Zmlnt 

ZmPrev 

ZmSquare.. 

ZmStats 

ZmTrig 

Zmllsr 

ZooDefault. 



10-112 
10-113 
10-114 
10-114 
10-114 



5-66, 



5-67, 



5-68, 



5-69, 



5-70, 



5-71, 



5-72, 



5-73, 



5-74, 



See Math 
See Math 
See Math 
See Math 
See Math 
See Graphing and Drawing 
See Graphing and Drawing 
See Graphing and Drawing 
See Graphing and Drawing 
See Graphing and Drawing 
See Graphing and Drawing 
See Graphing and Drawing 
See Graphing and Drawing 
See Graphing and Drawing 
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ACC 
Address 

APD™ 
API 

Applet 

Archive 
memory 

ASAP 

ASCII 

Assembler 



Assembly 
language 



Binary 



Bit 



ACC stands for accumulator. 

A number given to a location in memory. You can access the location by 
using that number, like accessing a variable by using its name. 

Automatic Power Down™. 

Application Programmer's Interface — the set of software services available 
to an application and the interface for using them. 

A stand-alone application, usually in Flash ROM, with the associated 
security mechanisms in place. See ASAP. 

Part of Flash ROM. You can store data, programs, or other variables to the 
user data archive, which cannot be edited or deleted inadvertently. 

Assembly Application Program — a RAM-resident application. 

American Standard Code for Information Interchange — a convention for 
encoding characters, numerals in a seven or eight-bit binary number. 

A program that converts source code into machine language that the 
processor can understand, similar to compilers used with high-level 
languages. 

A low-level language used to program microprocessors directly. Z80 
assembly language can be used on the TI-83 Plus to write programs that 
execute faster than programs written in TI-BASIC. See Chapter 3 for 
advantages and disadvantages. 

A system of counting using O's and 1's. The first seven digits and the 
decimal equivalents are: 



0 


0 


1 


1 


10 


2 


11 


3 


100 


4 


101 


5 


110 


6 


111 


7 



See also Hexadecimal. 

Short for binary digit — either 1 or 0. In computer processing and storage, a 
bit is the smallest unit of information handled by a computer and is 
represented physically by an element such as a single pulse sent through a 
circuit or a small spot on a magnetic disk capable of storing either a 1 or a 0. 
Considered singly, bits convey little information a human would consider 
meaningful. In groups of eight, however, bits become the familiar bytes used 
to represent all types of information, including the letters of the alphabet and 
the digits 0 through 9. (Microsoft Encarta '97) 
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Boot (code) 
Byte 



Calculator 
serial number 

Character 



Compiled 
language 

Compiler 

D-Bus 



Decimal 
E-Bus 

Entry points 

Execute 
Flash-D 



Freeware 



Garbage 
collection 

TItGRAPH 
LINK™ 

Group 
certificate 



A small amount of software that resides in ROM; therefore, it cannot be 
overwritten or erased. Boot code is required for the calculator to manage the 
installation of new base code. 

A unit of information consisting of 8 bits, the equivalent of a single character, 
such as a letter. 8 bits equal {0-255} and there are 256 letters in the 
extended ASCII character set. Standard ASCII uses a 7-bit value (0-127), 
thus there are 1 28 characters. 

An electronic serial number that resides in a calculator's Flash memory. It is 
used to uniquely identify that calculator. 

A single letter, digit, or symbol. Q is a character. 4 is a character. % is a 
character. 123 and yo are not characters. 

A language that must be compiled before you can run the program. 
Examples include C/C++ and Pascal. 

A compiler translates high-level language source code into machine code. 

A proprietary communication bus used between calculators, the 
Calculator-Based Laboratory™ (CBL™) System, the Calculator-Based 
Ranger™ (CBR™) and personal computers. 

The standard (base 10) system of counting, as opposed to binary (base 2) 
or hexadecimal (base 16). 

Enhanced D-Bus. 

Callable locations in the base code corresponding to pieces of code that 
exhibit some coherent functionality. 

To run a program or carry out a command. 

A PC program that is the integration of a PC downloader application with a 
calculator application. When the Flash-D program is executed on the PC, 
the calculator application is transferred to the calculator via a 
TI-GRAPH LINK™ cable. 

Programs or databases that an individual may use without payment of 
money to the author. Commonly, the author will copyright the work as a way 
of legally insisting that no one change it prior to getting approval. Commonly, 
the author will issue a license defining the terms under which the 
copyrighted program may be used. With freeware, there is no charge for the 
license. 

A procedure that automatically determines what memory a program is no 
longer using and recycles it for other use. This is also known as automatic 
storage (or memory) reclamation. 

An optional accessory that links a calculator to a personal computer to 
enable communication. 

Used to identify several calculators as a single unit. This allows the group of 
calculators, or unit, to be assigned a new program license using only one 
certificate (instead of requiring a new unique unit certificate for each 
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Hexadecimal 

High-level 
language 



IDE 

Immediate 



Interpreted 
language 



Instruction 

I/O port 

LCD port 

Low-level 
language 

Machine 
language 

Mac Link 
Marked Dirty 

Memory 



calculator in the group). The group certificate must be used in conjunction 
with the unit certificate. 

Base 16 system, which is often used in computing. Counting is as follows: 
{0,1,2,3,4,5,6,7,8,9AB,C,D,E,F}. 

Any programming language that resembles English. This makes it easier for 
humans to understand. Unfortunately, a computer cannot understand it 
unless it is compiled into machine language. See also low-level language. 
Examples of high-level languages are C/C++, Pascal, FORTRAN, COBOL, 
Ada, etc. 

Integrated Development Environment. 

An addressing mode where the data value is contained within the instruction 
instead of being loaded from somewhere else. For example, in LD A, 17, 17 
is an immediate value. In LD A, B, the value in B is not immediate, because 
it is not written into the code. 

A language that is changed from source code to machine language in real- 
time. Examples are BASIC (for the PC and the Tl version, TI-BASIC) and 
JavaScript. Interpreted languages are often much simpler, which helps 
beginners get started and allows experienced programmers to write code 
quickly. Interpreted languages, however, are restricted in their capability, 
and they run slower. 

A command that tells the processor to do something, for example, add two 
numbers or get some data from the memory. 

An input/output interface from the calculator to the external world. It allows 
communication with other units, CBL™ and CBR™, and personal computers. 

An output port that drives LCD display device for use on overhead 
projectors. Available on the teacher's ViewScreen™ calculator only. 

Any programming language that does not look like English but is still to be 
understandable by people. It uses words like add to replace machine 
language instructions like 110100. See also high-level language. 

Any programming language that consists of 1's and O's (called binary), 
which represents instructions. A typical machine instruction could be 
1 1 01 00, which means add two numbers together. 

Macintosh resident link software that can communicate with the calculator. 

The graph is marked as needing to be updated. The next system routine 
that will affect the graph contents will cause the system to regraph all of the 
equations selected thereby making the graph clean. 

Memory is where data is stored. On the Tl— 83 Plus, the main memory is the 
built-in 32K of RAM. This memory is composed of one-byte sections, each 
with a unique address. 



Microprocessor See processor. 

Operating The software included with every new calculator. OS contains the features 

System (OS) that are of interest to customers, as well as behind-the-scenes functionality 
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Processor 

Program 

Program ID 
number 



Program 
license 



Register 
Register pair 



Run (Busy) 
Indicator 



SDK 

Shareware 



that allows the calculator to operate and communicate. In our newer 
calculators, the OS is in Flash ROM, so the user can electronically upgrade 
it with OS. 

A large computer chip that does most of the work in a computer or 
calculator. The processor in the TI-83 Plus is the Zilog Z80 chip. 

A program is a list of instructions written in sequential order for the 
processor to execute. 

An ID number assigned to a particular software program. It is used during 
the program authentication process to match the program licenses in a 
unit/group certificate to the program being downloaded into the calculator. 

A digital license purchased by a customer allowing the customer to authorize 
the download/execution of a particular software program to a specific 
calculator. The program licenses are assigned to and listed in the calculator 
unit/group certificates. 

A register is high-speed memory typically located directly on the processor. 
It is used to store data while the processor manipulates it. On the TI-83 Plus 
there are 14 registers. 

Two registers being used as if they were one, creating a 16-bit register. 
Larger numbers can be used in registered pairs than in single registers. The 
register pairs are AF, BC, DE, and HL. Register pairs are often used to hold 
addresses. 

When the TI-83 Plus is calculating or graphing, a vertical moving line is 
displayed as a busy indicator in the top-right corner of the screen. When you 
pause a graph or a program, the busy indicator becomes a vertical moving 
dotted line. 

Software Development Kit — a set of tools that allow developers to write 
software for specific platforms. 

Sometimes called User Supported or Try Before You Buy software. 
Shareware is not a particular kind of software, it is a way of marketing 
software. Users are permitted to try the software on their own computer 
systems (generally for a limited period of time) without any cost of obligation. 
Payment is required if the user has found the software to be useful or if the 
user wishes to continue using the software beyond the evaluation (trial) 
period. 

Payment of the registration fee to the author will bring the user a license to 
continue using the software. Most authors will include other materials in 
return for the registration fee — like printed manuals, technical support, 
bonus or additional software, or upgrades. 

Shareware is commercial software, fully protected by copyright laws. Like 
other business owners, shareware authors expect to earn money from 
making their software available. In addition, by paying, the user may then be 
entitled to additional functions, removal of time limiting or limits on use, 
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Signed 
application 

Silent link 



Software 

owner's 

account 

Source code 



TASM 



TI-BASIC 



Tl signature 

User Data 
Archive 

Unique 
owner ID 

Unit 

certificate 

Z80 

ZDS 



removal of so-called nag screens, and other things as defined in the 
documentation provided by the program's author. 

An application that has been digitally signed by Tl. 

Computer-initiated request — protocol version of communications between 
the computer and the calculator. 

An account set-up in the Tl database listing all of the program licenses 
owned by a particular customer or group. The account also allows the 
software owner to assign a particular program to a specific calculator. 

A text file containing the code, usually in a high-level or low-level 
programming language. 

Table Assembler — a PC program that assembles source code for the Z80 
and other processors. This has been one of the more popular tools for 
developing calculator ASM programs. 

The programming language commonly used on the Tl— 83 Plus. It is the 
language that is used for PROGRAM variables. Its main drawback is that 
these programs run slower, since it is an interpreted language, rather than a 
compiled language. 

A digital signature placed on secured documents/files such as unit and 
group certificates, as well as software program images. 

Storage for user data in the Flash ROM. In some cases, the user can 
choose between the amount of Flash for applets versus user data. 

An alphanumeric ID assigned to the owner of a software owner's account as 
a way of authorizing access to this account. Examples of the ID are mother's 
maiden name, social security number, birth date, etc. 

A digital certificate signed by Tl that lists all of the program and group 
licenses issued to a specific calculator. The unit certificate also includes 
owner ID information and the calculator serial number. 

This processor is used in the Tl— 83 Plus. Z80 assembler is the language 
used to program the Z80 chip. 

Zilog Development Studio — a tool used by developers to write software for 
Zilog products. This tool can be used to develop TI-83 Plus calculator 
applications and ASM programs. 
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